Node.js microbenchmark tests & framework
npm install microbench
|6||downloads in the last month|
|Version||0.0.3 last updated a year ago|
|Keywords||utilities, utils, tools, benchmark|
|Dependencies||expose, cli-table, colors, progress, commander|
A node.js module for microbenchmarking which includes:
- A basic set of JS language construct microbenchmarks.
- An ad hoc microbenchmark framework for synchronous based testing.
This module is primarily intended for my personal consumption and grew out of the need to easily create, execute and archive microbenchmarks which help guide implementation decisions when performance is a priority. It's creation was also a partial learning experience in further understanding the optimizations that V8 makes on your JS code.
That said, the code found here was thrown together very quickly (a few hrs) and is not documented nor the prettiest src in the world.
Finally, we all know microbenchmarks should be taken with a grain of salt and used in accordance with project goals... This is standard stuff, so no further divulgence.
A sample of microbenchmark results can be found under the results directory.
Installation via git repo
The easiest way to run the microbenchmarks is to just clone the repo:
git clone https://github.com/bodenr/microbench.git
Then install the dependencies:
And finally run the test suite:
Installation via npm
The module is also package via npm and can be installed with:
npm install microbench
To run the benchmarks:
cd node_modules/microbench ./bin/microbench
The microbench command
The module contains a simple
microbench binary to run benchmarks
which can be found under the
/bin directory of the module.
It supports the following options:
Usage: microbench [options] Options: -h, --help output usage information -V, --version output the version number -b, --benchmarks <path> directory containing benchmark js files [./benchmarks] -a, --archive [path] archive results in markdown format [./results] -g, --grep <pattern> select benchmarks by name or pattern -u, --ungrep <pattern> unselect benchmarks by name or pattern -o, --only <pattern> only run categories who's name includes the pattern -s, --skip <pattern> skip categories who's name includes the pattern
Run all benchmark js files under
microbench -b /home/boden/projects/js/benchmarks
Run only benchmark js files which contain
simple in the name found
microbench -b /home/boden/projects/js/benchmarks -g simple
Run all benchmark js files which don't contain
long in the name found
microbench -b /home/boden/projects/js/benchmarks -u long
Run all benchmark js file which contain
type in the filename and
who's category contains the string
microbench -g type -o prototype
microbench uses a cli-table
to display output:
You can ask it to archive your bench results in markdown format using the
-a option. For example to run all benchmark js files under
and archive them under
microbench -a /tmp/benchmark/results
(The MIT License)
Copyright (c) 2012 Boden Russell <email@example.com>
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.