chore: Add benchmarks for JS bindings

Author: Stranger6667

README.md

@@ -41,6 +41,7 @@ into:
 - Works on Linux, Windows, and macOS
 - Supports HTML5 & CSS3
 - Bindings for [Python](https://github.com/Stranger6667/css-inline/tree/master/bindings/python), [Ruby](https://github.com/Stranger6667/css-inline/tree/master/bindings/ruby), [JavaScript](https://github.com/Stranger6667/css-inline/tree/master/bindings/javascript), [C](https://github.com/Stranger6667/css-inline/tree/master/bindings/c), and a [WebAssembly](https://github.com/Stranger6667/css-inline/tree/master/bindings/javascript/wasm) module to run in browsers.
+- Command Line Interface
 
 ## Playground
 

bindings/javascript/README.md

@@ -132,6 +132,23 @@ The `data-css-inline="ignore"` attribute also allows you to skip `link` and `sty
 </script>
 ```
 
+## Performance
+
+`css-inline` is powered by efficient tooling from Mozilla's Servo project and significantly outperforms other JavaScript alternatives in terms of speed.
+Most of the time it achieves over a **4x** speed advantage compared to the next fastest alternative.
+
+Here is the performance comparison:
+
+|             | Size    | `css-inline 0.11.2` | `css-inline-wasm 0.11.2` | `juice 10.0.0`        | `inline-css 4.0.2`     |
+|-------------|---------|---------------------|--------------------------|-----------------------|------------------------|
+| Basic       | 230 B   | 15.19 µs            | 29.33 µs (**1.93x**)     | 142.53 µs (**9.38x**) | 163.77 µs (**10.78x**) |
+| Realistic-1 | 8.58 KB | 336.81 µs           | 638.97 µs (**1.90x**)    | 1.28 ms (**3.80x**)   | 1.87 ms (**5.57x**)    |
+| Realistic-2 | 4.3 KB  | 210.52 µs           | 385.20 µs (**1.82x**)    | 1.72 ms (**8.18x**)   | 1.56 ms (**7.44x**)    |
+
+The "Basic" case was obtained from benchmarking the example from the Usage section.
+
+The benchmarking code is available in the `benches/bench.ts` file. The benchmarks were conducted using the stable `rustc 1.74.1` on Node.js `v21.4.0`.
+
 ## License
 
 This project is licensed under the terms of the [MIT license](https://opensource.org/licenses/MIT).

bindings/javascript/benches/bench.ts

@@ -0,0 +1,38 @@
+import { promises as fs } from "fs";
+import { join } from "path";
+import b from "benny";
+import juice from "juice";
+import inlineCss from "inline-css";
+
+import { inline } from "../index";
+import { initWasm, inline as wasmInline } from "../wasm";
+
+async function run() {
+  const benchmarksPath = join(__dirname, "../../../benchmarks/benchmarks.json");
+  const benches = JSON.parse(await fs.readFile(benchmarksPath, "utf-8"));
+  await initWasm(fs.readFile(join(__dirname, "../wasm/index_bg.wasm")));
+
+  for (const { name, html } of benches) {
+    await b.suite(
+      name,
+      b.add("css-inline", () => {
+        inline(html);
+      }),
+      b.add("css-inline-wasm", () => {
+        wasmInline(html);
+      }),
+      b.add("juice", () => {
+        juice(html);
+      }),
+      b.add("inline-css", () => {
+        inlineCss(html);
+      }),
+      b.cycle(),
+      b.complete(),
+    );
+  }
+}
+
+run().catch((e) => {
+  console.error(e);
+});

bindings/javascript/package.json

@@ -38,9 +38,12 @@
     "@swc/core": "^1.3.101",
     "@types/copyfiles": "^2",
     "ava": "^6.0.1",
+    "benny": "^3.7.1",
     "copyfiles": "^2.4.1",
     "dts-bundle-generator": "^9.1.0",
     "esbuild": "^0.19.10",
+    "inline-css": "^4.0.2",
+    "juice": "^10.0.0",
     "npm-run-all2": "^6.1.1",
     "typescript": "^5.3.3"
   },
@@ -65,6 +68,7 @@
   },
   "scripts": {
     "artifacts": "napi artifacts",
+    "bench": "node -r @swc-node/register benches/bench.ts",
     "bundle": "run-p 'bundle:*'",
     "bundle:js": "node bundle.js",
     "bundle:dts": "dts-bundle-generator --external-types -o wasm/index.d.ts wasm-binding.ts",