GitHub - icebob/benchmarkify: ⚡ Benchmark framework for NodeJS (original) (raw)

⚡ benchmarkify

Benchmark framework for Node.js for measure the execution time of JS codes. It can generate JSON result, chart image or draw a simple bar chart to the console.

Installation

Usage

Example benchmark suite

const Benchmarkify = require("benchmarkify");

// Create a new benchmark // The .printHeader method will print the name of benchmark & some // information from the OS/PC to the console. const benchmark = new Benchmarkify("Simple example", { description: "This is a common benchmark", chartImage: true }).printHeader();

// Create a test suite benchmark.createSuite("String concatenate", { time: 1000, description: "Concatenate string in different ways" })

.add("Concat with '+'", () => {
    let s = "";
    for (let i = 0; i < 1000; i++)
        s += "test" + i;
    return s;
})

.ref("Concat with array & join", () => {
    let s = [];
    for (let i = 0; i < 1000; i++)
        s.push("test" + i);
    return s.join();
});

benchmark.run();

Output

==================
  Simple example
==================

Platform info:
==============
   Windows_NT 10.0.19045 x64
   Node.JS: 18.16.0
   V8: 10.2.154.26-node.26
   CPU: 13th Gen Intel(R) Core(TM) i5-13500 × 20
   Memory: 32 GB

Suite: String concatenate
=========================

√ Concat with '+'                105 533 ops/sec
√ Concat with array & join        57 987 ops/sec

   Concat with '+'                +81,99%    (105 533 ops/sec)   (avg: 9μs)
   Concat with array & join (#)        0%     (57 987 ops/sec)   (avg: 17μs)

┌──────────────────────────┬────────────────────────────────────────────────────┐
│ Concat with '+'          │ ██████████████████████████████████████████████████ │
├──────────────────────────┼────────────────────────────────────────────────────┤
│ Concat with array & join │ ███████████████████████████                        │
└──────────────────────────┴────────────────────────────────────────────────────┘

Chart: https://image-charts.com/chart.js/2.8.0?bkg=white&c=%7B%22type%22%3A%22bar%22%2C%22data%22%3A%7B%22labels%22%3A%5B%22Concat%20with%20%27%2B%27%22%2C%22Concat%20with%20array%20%26%20join%22%5D%2C%22datasets%22%3A%5B%7B%22label%22%3A%22Dataset%201%22%2C%22backgroundColor%22%3A%22rgba%2854%2C%20162%2C%20235%2C%200.5%29%22%2C%22borderColor%22%3A%22rgb%2854%2C%20162%2C%20235%29%22%2C%22borderWidth%22%3A1%2C%22data%22%3A%5B105532.65917212216%2C57986.883366982394%5D%7D%5D%7D%2C%22options%22%3A%7B%22responsive%22%3Afalse%2C%22legend%22%3A%7B%22display%22%3Afalse%2C%22position%22%3A%22top%22%7D%2C%22title%22%3A%7B%22display%22%3Atrue%2C%22text%22%3A%22String%20concatenate%7C%28ops%2Fsec%29%22%7D%2C%22layout%22%3A%7B%22padding%22%3A20%7D%7D%7D
-----------------------------------------------------------------------

Example chart image

JSON result

If you need the results in JSON use .then after run()

benchmark.run().then(res => console.log(res));

Result on the console:

{ name: 'Simple example', description: 'This is a common benchmark', meta: {}, suites: [ { name: 'String concatenate', description: 'Concatenate string in different ways', meta: {}, unit: 'ops/sec', tests: [ { name: "Concat with '+'", meta: {}, unit: 'ops/sec', fastest: true, stat: { duration: 1.0064495, cycle: 106, count: 106000, avg: 0.000009494806603773585, rps: 105320.73392654078, percent: 83.58339098878338 } }, { name: 'Concat with array & join', meta: {}, unit: 'ops/sec', reference: true, stat: { duration: 1.0109915, cycle: 58, count: 58000, avg: 0.000017430887931034482, rps: 57369.423976363796, percent: 0 } } ] } ], timestamp: 1693594301782, generated: 'Fri Sep 01 2023 20:51:41 GMT+0200 (közép-európai nyári idő)', elapsedMs: 2466 }

API

Class Benchmarkify

const benchmark = new Benchmarkify("Benchmark #1", opts);

Constructor options

• logger - print messages to this logger. Default: console
• spinner - show spinner when running tests. Default: true
• minSamples - Minimum samples. Default: 0 - not used
• description - Custom description field.
• meta - To store any meta information. Result JSON contains it.
• chartImage - Generate chart image url and print to the console after every suite.
• drawChart - Draw a bar chart to the console after every suite. Default: true

Methods

• createSuite - Create a new benchmark suite.
• run(suites: Array): Promise -

Class Suite

const bench1 = benchmark.createSuite("Date performance", { time: 1000 });

Constructor options

• name - Name of suite.
• time - Time of test. Default: 5000 (5sec)
• minSamples - Minimum samples. Default 0 - disabled
• description - Custom description field.
• unit - Measurement unit. Default: "ops/sec".
• meta - To store any meta information. Result JSON contains it.

Methods

• add(name: string, fn: Function, opts: Object) - Add a function to the suite
• skip(name: string, fn: Function, opts: Object) - Skip the function
• only(name: string, fn: Function, opts: Object) - Run only this function
• ref(name: string, fn: Function, opts: Object) - Add a function and it'll be the reference
• run(): Promise - Run the suite.
• setup(fn): Promise - Function to execute before test suite.
• tearDown(fn): Promise - Function to execute after test suite.

Async functions

If you would like to test async function use the done callback.

bench.add("Async call test", done => { asyncFunction(data).then(() => done()); });

or

bench.add("Async call test", async done => { await asyncFunction(data) done(); });

License

Benchmarkify is available under the MIT license.

Contact

Copyright (C) 2023 Icebob