Benchmark.js

A benchmarking library. As used on jsPerf.com.

Performance
bestiejs/benchmark.jsbenchmarkjs.com/benchmark

README

Benchmark.js v2.1.4


A robust benchmarking library that supports high-resolution timers & returns statistically significant results. As seen on jsPerf.

Documentation


API Documentation

Download


Development source

Installation


Benchmark.js’ only hard dependency is lodash.
Include platform.js to populate Benchmark.platform.

In a browser:

  1. ``` html
  2. <script src="lodash.js"></script>
  3. <script src="platform.js"></script>
  4. <script src="benchmark.js"></script>
  5. ```

In an AMD loader:

  1. ``` js
  2. require({
  3.   'paths': {
  4.     'benchmark': 'path/to/benchmark',
  5.     'lodash': 'path/to/lodash',
  6.     'platform': 'path/to/platform'
  7.   }
  8. },
  9. ['benchmark'], function(Benchmark) {/*…*/});
  10. ```

Using npm:

  1. ``` sh
  2. $ npm i --save benchmark
  3. ```

In Node.js:

  1. ``` js
  2. var Benchmark = require('benchmark');
  3. ```

Optionally, use the microtime module by Wade Simmons:

  1. ``` sh
  2. npm i --save microtime
  3. ```

Usage example:

  1. ``` js
  2. var suite = new Benchmark.Suite;

  4. // add tests
  5. suite.add('RegExp#test', function() {
  6.   /o/.test('Hello World!');
  7. })
  8. .add('String#indexOf', function() {
  9.   'Hello World!'.indexOf('o') > -1;
  10. })
  11. // add listeners
  12. .on('cycle', function(event) {
  13.   console.log(String(event.target));
  14. })
  15. .on('complete', function() {
  16.   console.log('Fastest is ' + this.filter('fastest').map('name'));
  17. })
  18. // run async
  19. .run({ 'async': true });

  21. // logs:
  22. // => RegExp#test x 4,161,532 +-0.99% (59 cycles)
  23. // => String#indexOf x 6,139,623 +-1.00% (131 cycles)
  24. // => Fastest is String#indexOf
  25. ```

Support


Tested in Chrome 54-55, Firefox 49-50, IE 11, Edge 14, Safari 9-10, Node.js 6-7, & PhantomJS 2.1.1.

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.