Node.js - v20.4.0

Notable Changes

Mock Timers

The new feature allows developers to write more reliable and predictable tests for time-dependent functionality.
It includes MockTimers with the ability to mock setTimeout, setInterval from globals, node:timers, and node:timers/promises.

The feature provides a simple API to advance time, enable specific timers, and release all timers.

import assert from 'node:assert';
import { test } from 'node:test';

test('mocks setTimeout to be executed synchronously without having to actually wait for it', (context) => {
  const fn = context.mock.fn();
  // Optionally choose what to mock
  context.mock.timers.enable(['setTimeout']);
  const nineSecs = 9000;
  setTimeout(fn, nineSecs);

  const threeSeconds = 3000;
  context.mock.timers.tick(threeSeconds);
  context.mock.timers.tick(threeSeconds);
  context.mock.timers.tick(threeSeconds);

  assert.strictEqual(fn.mock.callCount(), 1);
});

This feature was contributed by Erick Wendel in #47775.

Support to the explicit resource management proposal

Node is adding support to the explicit resource management
proposal to its resources allowing users of TypeScript/babel to use using/await using with
V8 support for everyone else on the way.

This feature was contributed by Moshe Atlow and Benjamin Gruenbaum in #48518.

Other notable changes

• [fe333d2584] - crypto: update root certificates to NSS 3.90 (Node.js GitHub Bot) #48416
• [60c2ea4e79] - doc: add vmoroz to collaborators (Vladimir Morozov) #48527
• [5cacdf9e6b] - doc: add kvakil to collaborators (Keyhan Vakil) #48449
• [504d1d7bdc] - (SEMVER-MINOR) tls: add ALPNCallback server option for dynamic ALPN negotiation (Tim Perry) #45190

Commits

• [8a611a387f] - benchmark: add bar.R (Rafael Gonzaga) #47729
• [12fa716cf9] - benchmark: refactor crypto oneshot (Filip Skokan) #48267
• [d6ecbde592] - benchmark: add crypto.create*Key (Filip Skokan) #48284
• [e60b6dedd8] - bootstrap: unify snapshot builder and embedder entry points (Joyee Cheung) #48242
• [40662957b1] - bootstrap: simplify initialization of source map handlers (Joyee Cheung) #48304
• [6551538079] - build: fix configure --link-module (Richard Lau) #48522
• [f7f32089e7] - build: sync libuv header change (Jiawen Geng) #48429
• [f60205c915] - build: update action to close stale PRs (Michael Dawson) #48196
• [4f4d0b802e] - child_process: improve spawn performance on Linux (Keyhan Vakil) #48523
• [fe333d2584] - crypto: update root certificates to NSS 3.90 (Node.js GitHub Bot) #48416
• [89aaf16237] - crypto: remove OPENSSL_FIPS guard for OpenSSL 3 (Richard Lau) #48392
• [6199e1946c] - deps: upgrade to libuv 1.46.0 (Santiago Gimeno) #48618
• [1b2b930fda] - deps: add loong64 config into openssl gypi (Shi Pujin) #48043
• [ba8d048929] - deps: update acorn to 8.9.0 (Node.js GitHub Bot) #48484
• [d96f921d06] - deps: update zlib to 1.2.13.1-motley-f81f385 (Node.js GitHub Bot) #48541
• [ed1d047e8f] - deps: update googletest to ec4fed9 (Node.js GitHub Bot) #48538
• [f43d718c67] - deps: update minimatch to 9.0.2 (Node.js GitHub Bot) #48542
• [2f66147cbf] - deps: update corepack to 0.19.0 (Node.js GitHub Bot) #48540
• [d91b0fde73] - deps: V8: cherry-pick 1a782f6543ae (Keyhan Vakil) #48523
• [112335e342] - deps: update corepack to 0.18.1 (Node.js GitHub Bot) #48483
• [2b141c413f] - deps: update icu to 73.2 (Node.js GitHub Bot) #48502
• [188b34d4a1] - deps: upgrade npm to 9.7.2 (npm team) #48514
• [bf0444b5d9] - deps: update zlib to 1.2.13.1-motley-3ca9f16 (Node.js GitHub Bot) #48413
• [b339d80a56] - deps: upgrade npm to 9.7.1 (npm team) #48378
• [4132931b87] - deps: update simdutf to 3.2.14 (Node.js GitHub Bot) #48344
• [8cd56c1e85] - deps: update ada to 2.5.1 (Node.js GitHub Bot) #48319
• [78cffcd645] - deps: update zlib to 982b036 (Node.js GitHub Bot) #48327
• [6d00c2e33b] - doc: fix options order (Luigi Pinca) #48617
• [7ad2d3a5d1] - doc: update security release stewards (Rafael Gonzaga) #48569
• [cc3a056fdd] - doc: update return type for describe (Shrujal Shah) #48572
• [99ae0b98af] - doc: run license-builder (github-actions[bot]) #48552
• [9750d8205c] - doc: add description of autoAllocateChunkSize in ReadableStream (Debadree Chatterjee) #48004
• [417927bb41] - doc: fix filename type in watch result (Dmitry Semigradsky) #48032
• [ca2ae86bd7] - doc: unnest mime and MIMEParams from MIMEType constructor (Dmitry Semigradsky) #47950
• [bda1228135] - doc: update security-release-process.md (Rafael Gonzaga) #48504
• [60c2ea4e79] - doc: add vmoroz to collaborators (Vladimir Morozov) #48527
• [37bc0eac4a] - doc: improve inspector.close() description (mary marchini) #48494
• [2a403cdad5] - doc: link to Runtime Keys in export conditions (Jacob Hummer) #48408
• [e2d579e644] - doc: update fs flags documentation (sinkhaha) #48463
• [38bf290115] - doc: revise error.md introduction (Antoine du Hamel) #48423
• [641a2e9c6d] - doc: add preveen-stack to triagers (Preveen P) #48387
• [4ab5e8d2e3] - doc: refine when file is undefined in test events (Moshe Atlow) #48451
• [5cacdf9e6b] - doc: add kvakil to collaborators (Keyhan Vakil) #48449
• [b9c643e3ef] - doc: add additional info on TSFN dispatch (Michael Dawson) #48367
• [17a0e1d1bf] - doc: add link for news from security wg (Michael Dawson) #48396
• [3a62994a4f] - doc: fix typo in events.md (Darshan Sen) #48436
• [e10a4cdf68] - doc: run license-builder (github-actions[bot]) #48336
• [19fde638fd] - fs: call the callback with an error if writeSync fails (killa) #47949
• [4cad9fd8bd] - fs: remove unneeded return statement (Luigi Pinca) #48526
• [d367b73f43] - fs: use kResistStopPropagation (Chemi Atlow) #48521
• [e50c3169af] - fs, stream: initial Symbol.dispose and Symbol.asyncDispose support (Moshe Atlow) #48518
• [7d8a0b6eb7] - http: null the joinDuplicateHeaders property on cleanup (Luigi Pinca) #48608
• [94ebb02f59] - http: server add async dispose (atlowChemi) #48548
• [c6a69e31a3] - http: remove useless ternary in test (geekreal) #48481
• [2f0f40328f] - http: fix for handling on boot timers headers and request (Franciszek Koltuniuk) #48291
• [5378ad8ab1] - http2: server add asyncDispose (atlowChemi) #48548
• [97a58c5970] - https: server add asyncDispose (atlowChemi) #48548
• [40ae6eb6aa] - https: fix connection checking interval not clearing on server close (Nitzan Uziely) #48383
• [15530fea4c] - lib: merge cjs and esm package json reader caches (Yagiz Nizipli) #48477
• [32bda81c31] - lib: reduce url getters on makeRequireFunction (Yagiz Nizipli) #48492
• [0da03f01ba] - lib: remove duplicated requires in check_syntax (Yagiz Nizipli) #48508
• [97b00c347d] - lib: add option to force handling stopped events (Chemi Atlow) #48301
• [fe16749649] - lib: fix output message when repl is used with pm (Rafael Gonzaga) #48438
• [8c2c02d28a] - lib: create weakRef only if any signals provided (Chemi Atlow) #48448
• [b6ae411ea9] - lib: remove obsolete deletion of bufferBinding.zeroFill (Chengzhong Wu) #47881
• [562b3d4856] - lib: move web global bootstrapping to the expected file (Chengzhong Wu) #47881
• [f9c0d5acac] - lib: fix blob.stream() causing hanging promises (Debadree Chatterjee) #48232
• [0162a0f5bf] - lib: add support for inherited custom inspection methods (Antoine du Hamel) #48306
• [159ab6627a] - lib: reduce URL invocations on http2 origins (Yagiz Nizipli) #48338
• [f0709fdc59] - module: add SourceMap.findOrigin (Isaac Z. Schlueter) #47790
• [4ec2d925b1] - module: reduce url invocations in esm/load.js (Yagiz Nizipli) #48337
• [2c363971cc] - net: improve network family autoselection handle handling (Paolo Insogna) #48464
• [dbf9e9ffc8] - node-api: provide napi_define_properties fast path (Gabriel Schulhof) #48440
• [87ad657777] - node-api: implement external strings (Gabriel Schulhof) #48339
• [4efa6807ea] - permission: handle end nodes with children cases (Rafael Gonzaga) #48531
• [84fe811108] - repl: display dynamic import variant in static import error messages (Hemanth HM) #48129
• [bdcc037470] - report: disable js stack when no context is entered (Chengzhong Wu) #48495
• [97bd9ccd04] - src: fix uninitialized field access in AsyncHooks (Jan Olaf Krems) #48566
• [404958fc96] - src: fix Coverity issue regarding unnecessary copy (Yagiz Nizipli) #48565
• [c4b8edea24] - src: refactor SplitString in util (Yagiz Nizipli) #48491
• [5bc13a4772] - src: revert IS_RELEASE (Rafael Gonzaga) #48505
• [4971e46051] - src: add V8 fast api to guessHandleType (Yagiz Nizipli) #48349
• [954e46e792] - src: return uint32 for guessHandleType (Yagiz Nizipli) #48349
• [05009675da] - src: make realm binding data store weak (Chengzhong Wu) #47688
• [120ac74352] - src: remove aliased buffer weak callback (Chengzhong Wu) #47688
• [6591826e99] - src: handle wasm out of bound in osx will raise SIGBUS correctly (Congcong Cai) #46561
• [1b84ddeec2] - src: implement constants binding directly (Joyee Cheung) #48186
• [06d49c1f10] - src: implement natives binding without special casing (Joyee Cheung) #48186
• [325441abf5] - src: add missing to_ascii method in dns queries (Daniel Lemire) #48354
• [84d0eb74b8] - stream: fix premature pipeline end (Robert Nagy) #48435
• [3df7368735] - test: add missing assertions to test-runner-cli (Moshe Atlow) #48593
• [07eb310b0d] - test: remove test-crypto-keygen flaky designation (Luigi Pinca) #48575
• [75aa0a7682] - test: remove test-timers-immediate-queue flaky designation (Luigi Pinca) #48575
• [a9756f3126] - test: add Symbol.dispose support to mock timers (Benjamin Gruenbaum) #48549
• [0f912a7248] - test: mark test-child-process-stdio-reuse-readable-stdio flaky (Luigi Pinca) #48537
• [30f4bc4985] - test: make IsolateData per-isolate in cctest (Joyee Cheung) #48450
• [407ce3fdcb] - test: define NAPI_VERSION before including node_api.h (Chengzhong Wu) #48376
• [24a8fa95f0] - test: remove unnecessary noop function args to mustNotCall() (Antoine du Hamel) #48513
• [09af579775] - test: skip test-runner-watch-mode on IBMi (Moshe Atlow) #48473
• [77cb1ee0b2] - test: add missing \ include for std::find (Sam James) #48380
• [7c790ca03c] - test: fix flaky test-watch-mode (Moshe Atlow) #48147
• [1398829746] - test: fix test-net-autoselectfamily for kernel without IPv6 support (Livia Medeiros) #48265
• [764119ba4b] - test: update url web-platform tests (Yagiz Nizipli) #48319
• [f1ead59629] - test: ignore the copied entry_point.c (Luigi Pinca) #48297
• [fc5d1bddcb] - test: refactor test-gc-http-client-timeout (Luigi Pinca) #48292
• [46a3d068a0] - test: update encoding web-platform tests (Yagiz Nizipli) #48320
• [141e5aad83] - test: update FileAPI web-platform tests (Yagiz Nizipli) #48322
• [83cfc67099] - test: update user-timing web-platform tests (Yagiz Nizipli) #48321
• [2c56835a33] - test_runner: fixed test shorthands return type (Shocker) #48555
• [7d01c8894a] - (SEMVER-MINOR) test_runner: add initial draft for fakeTimers (Erick Wendel) #47775
• [de4f14c249] - test_runner: add enqueue and dequeue events (Moshe Atlow) #48428
• [5ebe3a4ea7] - test_runner: make --test-name-pattern recursive (Moshe Atlow) #48382
• [93bf447308] - test_runner: refactor coverage report output for readability (Damien Seguin) #47791
• [504d1d7bdc] - (SEMVER-MINOR) tls: add ALPNCallback server option for dynamic ALPN negotiation (Tim Perry) #45190
• [203c3cf4ca] - tools: update lint-md-dependencies (Node.js GitHub Bot) #48544
• [333907b19d] - tools: speedup compilation of js2c output (Keyhan Vakil) #48160
• [10bd5f4d97] - tools: update lint-md-dependencies (Node.js GitHub Bot) #48486
• [52de27b9fe] - tools: pin ruff version number (Rich Trott) #48505
• [4345526644] - tools: replace sed with perl (Luigi Pinca) #48499
• [6c590835f3] - tools: automate update openssl v16 (Marco Ippolito) #48377
• [90b5335338] - tools: update eslint to 8.43.0 (Node.js GitHub Bot) #48487
• [cd83530a11] - tools: update doc to to-vfile\@8.0.0 (Node.js GitHub Bot) #48485
• [e500b439bd] - tools: prepare tools/doc for to-vfile 8.0.0 (Rich Trott) #48485
• [d623616813] - tools: update lint-md-dependencies (Node.js GitHub Bot) #48417
• [a2e107dde4] - tools: update create-or-update-pull-request-action (Richard Lau) #48398
• [8009e2c3be] - tools: update eslint-plugin-jsdoc (Richard Lau) #48393
• [10385c8565] - tools: add version update to external dependencies (Andrea Fassina) #48081
• [b1cef81b18] - tools: update eslint to 8.42.0 (Node.js GitHub Bot) #48328
• [0923dc0b8e] - tools: disable jsdoc/no-defaults rule (Luigi Pinca) #48328
• [b03146da85] - typings: remove unused primordials (Yagiz Nizipli) #48509
• [e9c9d187b9] - typings: fix JSDoc in ESM loader modules (Antoine du Hamel) #48424
• [fafe651d23] - url: conform to origin getter spec changes (Yagiz Nizipli) #48319