2023-01-03, Version 18.13.0 'Hydrogen' (LTS)

danielleadams · danielleadams · commit e2b8a608ef63 · 2022-12-30T15:37:03.000-05:00
Notable changes: Add support for externally shared js builtins: By default Node.js is built so that all dependencies are bundled into the Node.js binary itself. Some Node.js distributions prefer to manage dependencies externally. There are existing build options that allow dependencies with native code to be externalized. This commit adds additional options so that dependencies with JavaScript code (including WASM) can also be externalized. This addition does not affect binaries shipped by the Node.js project but will allow other distributions to externalize additional dependencies when needed. Contributed by Michael Dawson in #44376 fs.watch recursive support on Linux: `fs.watch` supports recursive watch using the `recursive: true` option. ```js const watcher = fs.watch(testDirectory, { recursive: true }); watcher.on('change', function(event, filename) { }); ``` Contributed by Yagiz Nizipli in #45098 Support function mocking on Node.js test runner: The `node:test` module supports mocking during testing via a top-level `mock` object. ```js test('spies on an object method', (t) => { const number = { value: 5, add(a) { return this.value + a; }, }; t.mock.method(number, 'add'); assert.strictEqual(number.add(3), 8); assert.strictEqual(number.add.mock.calls.length, 1); }); ``` Contributed by Colin Ihrig in #45326 Other notable changes: buffer: * (SEMVER-MINOR) introduce File (Khafra) #45139 build: * disable v8 snapshot compression by default (Joyee Cheung) #45716 crypto: * update root certificates (Luigi Pinca) #45490 deps: * update ICU to 72.1 (Michaël Zasso) #45068 doc: * add doc-only deprecation for headers/trailers setters (Rich Trott) #45697 * add Rafael to the tsc (Michael Dawson) #45691 * deprecate use of invalid ports in `url.parse` (Antoine du Hamel) #45576 * add lukekarrys to collaborators (Luke Karrys) #45180 * add anonrig to collaborators (Yagiz Nizipli) #45002 * deprecate url.parse() (Rich Trott) #44919 lib: * drop fetch experimental warning (Matteo Collina) #45287 net: * (SEMVER-MINOR) add autoSelectFamily and autoSelectFamilyAttemptTimeout options (Paolo Insogna) #44731 * src: * (SEMVER-MINOR) add uvwasi version (Jithil P Ponnan) #45639 * (SEMVER-MINOR) add initial shadow realm support (Chengzhong Wu) #42869 test_runner: * (SEMVER-MINOR) add t.after() hook (Colin Ihrig) #45792 * (SEMVER-MINOR) don't use a symbol for runHook() (Colin Ihrig) #45792 tls: * (SEMVER-MINOR) add "ca" property to certificate object (Ben Noordhuis) #44935 * remove trustcor root ca certificates (Ben Noordhuis) #45776 tools: * update certdata.txt (Luigi Pinca) #45490 util: * add fast path for utf8 encoding (Yagiz Nizipli) #45412 * improve textdecoder decode performance (Yagiz Nizipli) #45294 * (SEMVER-MINOR) add MIME utilities (#21128) (Bradley Farias) #21128 PR-URL: #46025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -33,7 +33,8 @@ release.
 </tr>
 <tr>
   <td valign="top">
-<b><a href="doc/changelogs/CHANGELOG_V18.md#18.12.1">18.12.1</a></b><br/>
+<b><a href="doc/changelogs/CHANGELOG_V18.md#18.13.0">18.13.0</a></b><br/>
+<a href="doc/changelogs/CHANGELOG_V18.md#18.12.1">18.12.1</a><br/>
 <a href="doc/changelogs/CHANGELOG_V18.md#18.12.0">18.12.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V18.md#18.11.0">18.11.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V18.md#18.10.0">18.10.0</a><br/>
diff --git a/doc/api/async_context.md b/doc/api/async_context.md
@@ -123,7 +123,7 @@ added:
  - v13.10.0
  - v12.17.0
 changes:
- - version: REPLACEME
+ - version: v18.13.0
    pr-url: https://github.com/nodejs/node/pull/45386
    description: Add option onPropagate.
 -->
diff --git a/doc/api/buffer.md b/doc/api/buffer.md
@@ -5025,7 +5025,7 @@ See [`Buffer.from(string[, encoding])`][`Buffer.from(string)`].
 ## Class: `File`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 > Stability: 1 - Experimental
@@ -5037,7 +5037,7 @@ A [`File`][] provides information about files.
 ### `new buffer.File(sources, fileName[, options])`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 * `sources` {string\[]|ArrayBuffer\[]|TypedArray\[]|DataView\[]|Blob\[]|File\[]}
@@ -5055,7 +5055,7 @@ added: REPLACEME
 ### `file.name`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 * Type: {string}
@@ -5065,7 +5065,7 @@ The name of the `File`.
 ### `file.lastModified`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 * Type: {number}
diff --git a/doc/api/cli.md b/doc/api/cli.md
@@ -418,7 +418,7 @@ Use this flag to disable top-level await in REPL.
 ### `--experimental-shadow-realm`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 Use this flag to enable [ShadowRealm][] support.
@@ -1199,7 +1199,7 @@ status code 1.
 <!-- YAML
 added: v18.1.0
 changes:
-  - version: REPLACEME
+  - version: v18.13.0
     pr-url: https://github.com/nodejs/node/pull/45214
     description: Test runner now supports running in watch mode.
 -->
@@ -1567,7 +1567,7 @@ amount of CPUs, but it may diverge in environments such as VMs or containers.
 <!-- YAML
 added: v18.11.0
 changes:
-  - version: REPLACEME
+  - version: v18.13.0
     pr-url: https://github.com/nodejs/node/pull/45214
     description: Test runner now supports running in watch mode.
 -->
diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
@@ -2288,7 +2288,7 @@ future release.
 
 <!-- YAML
 changes:
-  - version: REPLACEME
+  - version: v18.13.0
     pr-url: https://github.com/nodejs/node/pull/44919
     description: \`url.parse()` is deprecated again in DEP0169.
   - version:
@@ -3272,7 +3272,7 @@ Node-API callbacks.
 <!-- YAML
 changes:
   - version:
-      - REPLACEME
+      - v18.13.0
     pr-url: https://github.com/nodejs/node/pull/44919
     description: Documentation-only deprecation.
 -->
@@ -3288,7 +3288,7 @@ issued for `url.parse()` vulnerabilities.
 <!-- YAML
 changes:
   - version:
-    - REPLACEME
+    - v18.13.0
     pr-url: https://github.com/nodejs/node/pull/45576
     description: Documentation-only deprecation.
 -->
@@ -3304,7 +3304,7 @@ an error in future versions of Node.js, as the [WHATWG URL API][] does already.
 <!-- YAML
 changes:
   - version:
-      - REPLACEME
+      - v18.13.0
     pr-url: https://github.com/nodejs/node/pull/45697
     description: Documentation-only deprecation.
 -->
diff --git a/doc/api/diagnostics_channel.md b/doc/api/diagnostics_channel.md
@@ -3,7 +3,7 @@
 <!-- YAML
 added: v15.1.0
 changes:
-  - version: REPLACEME
+  - version: v18.13.0
     pr-url: https://github.com/nodejs/node/pull/45290
     description: diagnostics_channel is now Stable.
 -->
diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -4313,7 +4313,7 @@ The `atime` and `mtime` arguments follow these rules:
 <!-- YAML
 added: v0.5.10
 changes:
-  - version: REPLACEME
+  - version: v18.13.0
     pr-url: https://github.com/nodejs/node/pull/45098
     description: Added recursive support for Linux, AIX and IBMi.
   - version:
diff --git a/doc/api/n-api.md b/doc/api/n-api.md
@@ -901,7 +901,7 @@ handle and/or callback scope inside the function body is not necessary.
 #### `napi_cleanup_hook`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 napiVersion: 3
 -->
 
diff --git a/doc/api/net.md b/doc/api/net.md
@@ -854,7 +854,7 @@ behavior.
 <!-- YAML
 added: v0.1.90
 changes:
-  - version: REPLACEME
+  - version: v18.13.0
     pr-url: https://github.com/nodejs/node/pull/44731
     description: Added the `autoSelectFamily` option.
   - version: v17.7.0
diff --git a/doc/api/stream.md b/doc/api/stream.md
@@ -1684,7 +1684,7 @@ has less then 64 KiB of data because no `highWaterMark` option is provided to
 ##### `readable.compose(stream[, options])`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 > Stability: 1 - Experimental
diff --git a/doc/api/test.md b/doc/api/test.md
@@ -294,7 +294,7 @@ test('a test that creates asynchronous activity', (t) => {
 ## Watch mode
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 > Stability: 1 - Experimental
@@ -735,7 +735,7 @@ describe('tests', async () => {
 ## Class: `MockFunctionContext`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 The `MockFunctionContext` class is used to inspect or manipulate the behavior of
@@ -744,7 +744,7 @@ mocks created via the [`MockTracker`][] APIs.
 ### `ctx.calls`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 * {Array}
@@ -766,7 +766,7 @@ mock. Each entry in the array is an object with the following properties.
 ### `ctx.callCount()`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 * Returns: {integer} The number of times that this mock has been invoked.
@@ -778,7 +778,7 @@ is a getter that creates a copy of the internal call tracking array.
 ### `ctx.mockImplementation(implementation)`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 * `implementation` {Function|AsyncFunction} The function to be used as the
@@ -815,7 +815,7 @@ test('changes a mock behavior', (t) => {
 ### `ctx.mockImplementationOnce(implementation[, onCall])`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 * `implementation` {Function|AsyncFunction} The function to be used as the
@@ -859,15 +859,15 @@ test('changes a mock behavior once', (t) => {
 ### `ctx.resetCalls()`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 Resets the call history of the mock function.
 
 ### `ctx.restore()`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 Resets the implementation of the mock function to its original behavior. The
@@ -876,7 +876,7 @@ mock can still be used after calling this function.
 ## Class: `MockTracker`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 The `MockTracker` class is used to manage mocking functionality. The test runner
@@ -887,7 +887,7 @@ Each test also provides its own `MockTracker` instance via the test context's
 ### `mock.fn([original[, implementation]][, options])`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 * `original` {Function|AsyncFunction} An optional function to create a mock on.
@@ -938,7 +938,7 @@ test('mocks a counting function', (t) => {
 ### `mock.getter(object, methodName[, implementation][, options])`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 This function is syntax sugar for [`MockTracker.method`][] with `options.getter`
@@ -947,7 +947,7 @@ set to `true`.
 ### `mock.method(object, methodName[, implementation][, options])`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 * `object` {Object} The object whose method is being mocked.
@@ -1001,7 +1001,7 @@ test('spies on an object method', (t) => {
 ### `mock.reset()`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 This function restores the default behavior of all mocks that were previously
@@ -1017,7 +1017,7 @@ function manually is recommended.
 ### `mock.restoreAll()`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 This function restores the default behavior of all mocks that were previously
@@ -1027,7 +1027,7 @@ not disassociate the mocks from the `MockTracker` instance.
 ### `mock.setter(object, methodName[, implementation][, options])`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 This function is syntax sugar for [`MockTracker.method`][] with `options.setter`
@@ -1118,7 +1118,7 @@ test('top level test', async (t) => {
 ### `context.after([fn][, options])`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 * `fn` {Function|AsyncFunction} The hook function. The first argument
diff --git a/doc/api/tls.md b/doc/api/tls.md
@@ -1173,7 +1173,7 @@ certificate.
 
 <!-- YAML
 changes:
-  - version: REPLACEME
+  - version: v18.13.0
     pr-url: https://github.com/nodejs/node/pull/44935
     description: Add "ca" property.
   - version:
diff --git a/doc/api/url.md b/doc/api/url.md
@@ -1521,7 +1521,7 @@ The formatting process operates as follows:
 <!-- YAML
 added: v0.1.25
 changes:
-  - version: REPLACEME
+  - version: v18.13.0
     pr-url: https://github.com/nodejs/node/pull/44919
     description: Documentation-only deprecation.
   - version:
diff --git a/doc/api/util.md b/doc/api/util.md
@@ -1023,7 +1023,7 @@ equality.
 ## Class: `util.MIMEType`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 > Stability: 1 - Experimental
@@ -1222,7 +1222,7 @@ console.log(JSON.stringify(myMIMES));
 ### Class: `util.MIMEParams`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 The `MIMEParams` API provides read and write access to the parameters of a
diff --git a/doc/api/vm.md b/doc/api/vm.md
@@ -347,7 +347,7 @@ console.log(globalVar);
 ### `script.sourceMapURL`
 
 <!-- YAML
-added: REPLACEME
+added: v18.13.0
 -->
 
 * {string|undefined}
diff --git a/doc/changelogs/CHANGELOG_V18.md b/doc/changelogs/CHANGELOG_V18.md
diff --git a/src/node_version.h b/src/node_version.h
