Documentation

Check out the documentation for complete integration instructions.

Installation

First, install the plugin @codspeed/tinybench-plugin and tinybench (if not already installed):

1npm install --save-dev @codspeed/tinybench-plugin tinybench

or with yarn:

1yarn add --dev @codspeed/tinybench-plugin tinybench

or with pnpm:

1pnpm add --save-dev @codspeed/tinybench-plugin tinybench

Usage

Let's create a fibonacci function and benchmark it with tinybench and the CodSpeed plugin:

1import { Bench } from "tinybench";
2import { withCodSpeed } from "@codspeed/tinybench-plugin";
3
4function fibonacci(n) {
5  if (n < 2) {
6    return n;
7  }
8  return fibonacci(n - 1) + fibonacci(n - 2);
9}
10
11const bench = withCodSpeed(new Bench());
12
13bench
14  .add("fibonacci10", () => {
15    fibonacci(10);
16  })
17  .add("fibonacci15", () => {
18    fibonacci(15);
19  });
20
21await bench.run();
22console.table(bench.table());

Here, a few things are happening:

• We create a simple recursive fibonacci function.

• We create a new Bench instance with CodSpeed support by using the withCodSpeed helper. This step is critical to enable CodSpeed on your benchmarks.

• We add two benchmarks to the suite and launch it, benching our fibonacci function for 10 and 15.

Now, we can run our benchmarks locally to make sure everything is working as expected:

1$ node benches/bench.mjs
2[CodSpeed] 2 benches detected but no instrumentation found
3[CodSpeed] falling back to tinybench
4
5┌─────────┬───────────────┬─────────────┬───────────────────┬──────────┬─────────┐
6│ (index) │   Task Name   │   ops/sec   │ Average Time (ns) │  Margin  │ Samples │
7├─────────┼───────────────┼─────────────┼───────────────────┼──────────┼─────────┤
8│    0    │ 'fibonacci10' │ '1,810,236' │ 552.4139857896414 │ '±0.18%' │ 905119  │
9│    1    │ 'fibonacci15' │  '177,516'  │ 5633.276191749634 │ '±0.14%' │  88759  │
10└─────────┴───────────────┴─────────────┴───────────────────┴──────────┴─────────┘

And... Congrats🎉, CodSpeed is installed in your benchmarking suite! Locally, CodSpeed will fallback to tinybench since the instrumentation is only available in the CI environment for now.

You can now run those benchmarks in your CI to continuously get consistent performance measurements.