Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 1,092 Commits
doc		doc
example/jsperf		example/jsperf
plugin		plugin
test		test
.gitattributes		.gitattributes
.gitignore		.gitignore
.travis.yml		.travis.yml
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
benchmark.js		benchmark.js
index.js		index.js
package.json		package.json

Repository files navigation

Benchmark.js v2.0.0

Arobust benchmarking library that supports high-resolution timers & returns statistically significant results. As seen onjsPerf.

Documentation

API Documentation
Check out ourunit tests &roadmap

Download

Development source

Installation

Benchmark.js’ only hard dependency islodash.Includeplatform.js to populateBenchmark.platform.

In a browser:

<scriptsrc="lodash.js"></script><scriptsrc="platform.js"></script><scriptsrc="benchmark.js"></script>

Optionally, enable Chrome’s microsecond timer by using thecommand line switch:

  --enable-benchmarking

In an AMD loader:

require({'paths':{'benchmark':'path/to/benchmark','lodash':'path/to/lodash','platform':'path/to/platform'}},['benchmark'],function(Benchmark){/*…*/});

Using npm:

$ npm i --save benchmark

In Node.js:

varBenchmark=require('benchmark');

Optionally, use themicrotime module by Wade Simmons:

npm install microtime

Usage example:

varsuite=newBenchmark.Suite;// add testssuite.add('RegExp#test',function(){/o/.test('Hello World!');}).add('String#indexOf',function(){'Hello World!'.indexOf('o')>-1;})// add listeners.on('cycle',function(event){console.log(String(event.target));}).on('complete',function(){console.log('Fastest is '+this.filter('fastest').map('name'));})// run async.run({'async':true});// logs:// => RegExp#test x 4,161,532 +-0.99% (59 cycles)// => String#indexOf x 6,139,623 +-1.00% (131 cycles)// => Fastest is String#indexOf

Support

Tested in Chrome 46-47, Firefox 42-43, IE 9-11, MS Edge 13, Safari 8-9, Node.js 0.8.28, 0.10.41, 0.12.9, 4.2.4, & 5.3.0, & PhantomJS 1.9.8.

BestieJS

Benchmark.js is part of the BestieJS“Best in Class” module collection. This means we promote solid browser/environment support, ES5+ precedents, unit testing, & plenty of documentation.