node/benchmark
Joyee Cheung 4eeeab09f0
benchmark: rewrite detect-esm-syntax benchmark
Syntax detection has been unflagged so it's no longer meaningful
to toggle the detection based on CLI flags. It was also previously
benchmarking cached module imports which isn't very meaningful
for subsequent loads. This patch updates the benchmark to toggle
the detection based on the presence of type field in the package.json,
and generates fixtures to benchmark fresh module loads.

PR-URL: https://github.com/nodejs/node/pull/55238
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
2024-10-09 14:16:01 +00:00
..
abort_controller benchmark: add AbortSignal.abort benchmarks 2024-04-10 20:16:04 +00:00
assert benchmark: add match and doesNotMatch bench 2024-09-05 15:02:30 +00:00
async_hooks lib: rewrite AsyncLocalStorage without async_hooks 2024-08-02 19:44:20 +00:00
blob benchmark: reduce the buffer size for blob 2024-04-17 19:33:44 +00:00
buffers benchmark: add buffer.isAscii benchmark 2024-09-06 17:46:49 +00:00
child_process
cluster
crypto crypto: make timingSafeEqual faster for Uint8Array 2024-04-08 11:36:53 +00:00
dgram
diagnostics_channel benchmark: enhance dc publish benchmark 2024-09-05 20:21:24 +00:00
dns
domain benchmark: update iterations of benchmark/domain/domain-fn-args.js 2024-03-04 10:05:28 +00:00
error errors: fix stacktrace of SystemError 2023-12-23 09:04:45 -08:00
es lib: prefer logical assignment 2024-10-09 06:42:16 +00:00
esm benchmark: rewrite detect-esm-syntax benchmark 2024-10-09 14:16:01 +00:00
events
fixtures benchmark: create benchmark for typescript 2024-09-25 17:25:18 +00:00
fs fs: refactoring declaratively with Array.fromAsync 2024-09-27 11:59:09 +02:00
http benchmark: adds groups to better separate benchmarks 2024-09-04 03:26:53 +00:00
http2
https
mime util: remove internal mime fns from benchmarks 2023-10-21 02:12:44 +00:00
misc benchmark: rename count to n 2024-08-10 20:07:54 +00:00
module benchmark: --no-warnings to avoid DEP/ExpWarn log 2024-09-15 16:57:10 +00:00
napi node-api: add external buffer creation benchmark 2024-09-14 00:29:22 +00:00
net stream: bump default highWaterMark 2024-03-13 19:02:14 +00:00
os os: improve tmpdir performance 2024-09-11 14:46:30 +00:00
path path: fix relative on Windows 2024-08-06 09:40:23 +00:00
perf_hooks lib: prefer logical assignment 2024-10-09 06:42:16 +00:00
permission benchmark: add no-warnings to process.has bench 2024-09-30 20:27:39 +00:00
process
querystring
readline
streams benchmark: add stream.compose benchmark 2024-08-12 12:40:04 +00:00
string_decoder
test_runner
timers
tls
ts benchmark: create benchmark for typescript 2024-09-25 17:25:18 +00:00
url benchmark: fix benchmark for file path and URL conversion 2024-08-25 13:41:13 +00:00
util benchmark: add dotenv benchmark 2024-09-18 00:30:39 +00:00
v8
validators lib: improve performance of validateStringArray and validateBooleanArray 2023-10-22 21:12:38 +00:00
vm vm: migrate ContextifyScript to cppgc 2024-08-30 16:58:31 +00:00
websocket lib: enable WebSocket by default 2024-02-04 14:03:39 +00:00
webstorage benchmark: add webstorage benchmark 2024-09-23 13:46:14 +00:00
webstreams stream: reduce overhead of transfer 2023-10-12 14:37:41 +00:00
worker
zlib lib: prefer logical assignment 2024-10-09 06:42:16 +00:00
_benchmark_progress.js
_cli.js benchmark: support --help in CLI 2024-08-06 18:21:27 +00:00
_cli.R
_http-benchmarkers.js lib: prefer logical assignment 2024-10-09 06:42:16 +00:00
_test-double-benchmarker.js
bar.R
common.js lib: prefer logical assignment 2024-10-09 06:42:16 +00:00
compare.js benchmark: inherit stdio/stderr instead of pipe 2024-04-13 18:01:28 +00:00
compare.R
cpu.sh benchmark,doc: add CPU scaling governor to perf 2024-09-04 19:21:18 +00:00
eslint.config_partial.mjs tools: move ESLint tools to tools/eslint 2024-06-11 06:58:51 +00:00
README.md benchmark,doc: mention bar.R to the list of scripts 2024-09-04 18:53:02 +00:00
run.js benchmark: inherit stdio/stderr instead of pipe 2024-04-13 18:01:28 +00:00
scatter.js
scatter.R

Node.js Core Benchmarks

This folder contains code and data used to measure performance of different Node.js implementations and different ways of writing JavaScript run by the built-in JavaScript engine.

For a detailed guide on how to write and run benchmarks in this directory, see the guide on benchmarks.

Table of Contents

File tree structure

Directories

Benchmarks testing the performance of a single node submodule are placed into a directory with the corresponding name, so that they can be executed by submodule or individually. Benchmarks that span multiple submodules may either be placed into the misc directory or into a directory named after the feature they benchmark. E.g. benchmarks for various new ECMAScript features and their pre-ES2015 counterparts are placed in a directory named es. Fixtures that are not specific to a certain benchmark but can be reused throughout the benchmark suite should be placed in the fixtures directory.

Other Top-level files

The top-level files include common dependencies of the benchmarks and the tools for launching benchmarks and visualizing their output. The actual benchmark scripts should be placed in their corresponding directories.

  • _benchmark_progress.js: implements the progress bar displayed when running compare.js
  • _cli.js: parses the command line arguments passed to compare.js, run.js and scatter.js
  • _cli.R: parses the command line arguments passed to compare.R
  • _http-benchmarkers.js: selects and runs external tools for benchmarking the http subsystem.
  • bar.R: R script for visualizing the output of benchmarks with bar plots.
  • common.js: see Common API.
  • compare.js: command line tool for comparing performance between different Node.js binaries.
  • compare.R: R script for statistically analyzing the output of compare.js
  • run.js: command line tool for running individual benchmark suite(s).
  • scatter.js: command line tool for comparing the performance between different parameters in benchmark configurations, for example to analyze the time complexity.
  • scatter.R: R script for visualizing the output of scatter.js with scatter plots.

Common API

The common.js module is used by benchmarks for consistency across repeated tasks. It has a number of helpful functions and properties to help with writing benchmarks.

createBenchmark(fn, configs[, options])

See the guide on writing benchmarks.

default_http_benchmarker

The default benchmarker used to run HTTP benchmarks. See the guide on writing HTTP benchmarks.

PORT

The default port used to run HTTP benchmarks. See the guide on writing HTTP benchmarks.

sendResult(data)

Used in special benchmarks that can't use createBenchmark and the object it returns to accomplish what they need. This function reports timing data to the parent process (usually created by running compare.js, run.js or scatter.js).