Documentation

Benchmarks · 26 August 2026

Measure the byte path, not just the parser.

These local benchmarks separate parser throughput, requested source chunks, install footprint, and same-corpus end-to-end overhead instead of collapsing them into one “fastest” claim. Live-network effects were not measured.

Method

The local harness builds the package ESM output, warms each parser mode, reports median/min/mean/max samples, and probes a controlled 500 KB response in 1 KB chunks. The competitive harness serves identical fixtures from one local HTTP server in the same Node process. The dated stream result below measures the repository code released as 2.1.4 using Darwin 25.6 arm64, Node.js 24.15.0, and npm 11.12.1.

Controlled stream probe

ModeSource bytes requestedConfigured ceiling500 KB page
Fast2 KB30 KBStops after </head>
Quality~202 KB200 KBContinues for body fallbacks

“Source bytes” includes one queued 1 KB stream chunk; the retained byte ceiling remains exact.

Same-corpus comparison

The competitive harness runs pinned packages against identical fixtures on one local server. The dated comparison and measurement notes are the single source for exact results, package versions, security sources, and caveats. Live-network effects are deliberately not inferred from localhost timings.

Package footprint

npm run benchmark reports the current tarball, unpacked package, entry-file, and runtime-dependency sizes. The evidence notes separately reproduce clean installs of the pinned published packages. Entry-file gzip size is not presented as a full application bundle.

Reproduce before quoting

npm ci
npm run benchmark

cd benchmarks/competitive
npm ci
npm run bench

The competitive lockfile pins every compared version. Exact npm-artifact and clean-install commands are documented in the complete evidence notes. Live benchmarks are network smoke tests, not competitive evidence.