2024-03-26, Version 20.12.0 'Iron' (LTS)

richardlau · richardlau · commit 94fb85426bac · 2024-03-25T20:19:49.000Z
Notable changes: build: * (SEMVER-MINOR) build opt to set local location of headers (Michael Dawson) #51525 crypto: * (SEMVER-MINOR) implement crypto.hash() (Joyee Cheung) #51044 * update root certificates to NSS 3.98 (Node.js GitHub Bot) #51794 doc: * add lemire to collaborators (Daniel Lemire) #51572 * add zcbenz to collaborators (Cheng Zhao) #51812 lib: * (SEMVER-MINOR) move encodingsMap to internal/util (Joyee Cheung) #51044 sea: * (SEMVER-MINOR) support sea.getRawAsset() (Joyee Cheung) #50960 * (SEMVER-MINOR) support embedding assets (Joyee Cheung) #50960 src: * (SEMVER-MINOR) print string content better in BlobDeserializer (Joyee Cheung) #50960 util: * (SEMVER-MINOR) add styleText API to text formatting (Rafael Gonzaga) #51850 vm: * (SEMVER-MINOR) support using the default loader to handle dynamic import() (Joyee Cheung) #51244 PR-URL: #52212
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -35,7 +35,8 @@ release.
 </tr>
 <tr>
   <td valign="top">
-<b><a href="doc/changelogs/CHANGELOG_V20.md#20.11.1">20.11.1</a></b><br/>
+<b><a href="doc/changelogs/CHANGELOG_V20.md#20.12.0">20.12.0</a></b><br/>
+<a href="doc/changelogs/CHANGELOG_V20.md#20.11.1">20.11.1</a><br/>
 <a href="doc/changelogs/CHANGELOG_V20.md#20.11.0">20.11.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V20.md#20.10.0">20.10.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V20.md#20.9.0">20.9.0</a><br/>
diff --git a/doc/api/cli.md b/doc/api/cli.md
@@ -106,7 +106,7 @@ If this flag is passed, the behavior can still be set to not abort through
 ### `--allow-addons`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 > Stability: 1.1 - Active development
@@ -367,7 +367,7 @@ Currently the support for run-time snapshot is experimental in that:
 ### `--build-snapshot-config`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 > Stability: 1 - Experimental
@@ -656,7 +656,7 @@ of `--enable-source-maps`.
 <!-- YAML
 added: v20.6.0
 changes:
-  - version: REPLACEME
+  - version: v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51289
     description: Add support to multi-line values.
 -->
diff --git a/doc/api/crypto.md b/doc/api/crypto.md
@@ -3634,7 +3634,7 @@ Both keys must have the same `asymmetricKeyType`, which must be one of `'dh'`
 
 <!-- YAML
 added:
- - REPLACEME
+ - v20.12.0
 -->
 
 > Stability: 1.2 - Release candidate
diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
@@ -3432,7 +3432,7 @@ deprecated. Get them from `fs.constants` or `fs.promises.constants` instead.
 
 <!-- YAML
 changes:
-  - version: REPLACEME
+  - version: v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51442
     description: End-of-Life.
   - version:
@@ -3453,7 +3453,7 @@ Please use `value instanceof WebAssembly.Module` instead.
 
 <!-- YAML
 changes:
-  - version: REPLACEME
+  - version: v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51020
     description: Documentation-only deprecation.
 -->
@@ -3467,7 +3467,7 @@ release lines. Please use [`dirent.parentPath`][] instead.
 
 <!-- YAML
 changes:
-  - version: REPLACEME
+  - version: v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51077
     description: Documentation-only deprecation.
 -->
diff --git a/doc/api/errors.md b/doc/api/errors.md
@@ -2406,7 +2406,7 @@ V8 startup snapshot even though Node.js isn't building one.
 ### `ERR_NOT_IN_SINGLE_EXECUTABLE_APPLICATION`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 The operation cannot be performed when it's not in a single-executable
@@ -2563,7 +2563,7 @@ and HTTP/2 `Server` instances.
 ### `ERR_SINGLE_EXECUTABLE_APPLICATION_ASSET_NOT_FOUND`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 A key was passed to single executable application APIs to identify an asset,
diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -6585,7 +6585,7 @@ value is determined by the `options.encoding` passed to [`fs.readdir()`][] or
 
 <!-- YAML
 added:
-  - REPLACEME
+  - v20.12.0
 -->
 
 > Stability: 1 – Experimental
@@ -6600,7 +6600,7 @@ The path to the parent directory of the file this {fs.Dirent} object refers to.
 added:
   - v20.1.0
   - v18.17.0
-deprecated: REPLACEME
+deprecated: v20.12.0
 -->
 
 > Stability: 0 - Deprecated: Use [`dirent.parentPath`][] instead.
diff --git a/doc/api/http2.md b/doc/api/http2.md
@@ -2893,7 +2893,7 @@ the given `Buffer` as generated by `http2.getPackedSettings()`.
 ### `http2.performServerHandshake(socket[, options])`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 * `socket` {stream.Duplex}
@@ -3662,7 +3662,7 @@ will result in a [`TypeError`][] being thrown.
 #### `response.appendHeader(name, value)`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 * `name` {string}
diff --git a/doc/api/n-api.md b/doc/api/n-api.md
@@ -794,7 +794,7 @@ handle and/or callback scope inside a `napi_callback` is not necessary.
 #### `node_api_nogc_finalize`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 > Stability: 1 - Experimental
@@ -3084,7 +3084,7 @@ The JavaScript `string` type is described in
 #### `node_api_create_property_key_utf16`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 > Stability: 1 - Experimental
diff --git a/doc/api/net.md b/doc/api/net.md
@@ -687,7 +687,7 @@ See [`net.createConnection()`][].
 ### Event: `'connectionAttempt'`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 * `ip` {string} The IP which the socket is attempting to connect to.
@@ -700,7 +700,7 @@ if the family autoselection algorithm is enabled in [`socket.connect(options)`][
 ### Event: `'connectionAttemptFailed'`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 * `ip` {string} The IP which the socket attempted to connect to.
@@ -714,7 +714,7 @@ if the family autoselection algorithm is enabled in [`socket.connect(options)`][
 ### Event: `'connectionAttemptTimeout'`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 * `ip` {string} The IP which the socket attempted to connect to.
diff --git a/doc/api/process.md b/doc/api/process.md
@@ -2265,7 +2265,7 @@ debugger. See [Signal Events][].
 ## `process.loadEnvFile(path)`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 > Stability: 1.1 - Active development
diff --git a/doc/api/single-executable-applications.md b/doc/api/single-executable-applications.md
@@ -279,7 +279,7 @@ from the JavaScript main script embedded into the executable.
 #### `sea.isSea()`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 * Returns: {boolean} Whether this script is running inside a single-executable
@@ -288,7 +288,7 @@ added: REPLACEME
 ### `sea.getAsset(key[, encoding])`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 This method can be used to retrieve the assets configured to be bundled into the
@@ -306,7 +306,7 @@ An error is thrown when no matching asset can be found.
 ### `sea.getAssetAsBlob(key[, options])`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 Similar to [`sea.getAsset()`][], but returns the result in a [`Blob`][].
@@ -321,7 +321,7 @@ An error is thrown when no matching asset can be found.
 ### `sea.getRawAsset(key)`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 This method can be used to retrieve the assets configured to be bundled into the
diff --git a/doc/api/util.md b/doc/api/util.md
@@ -1598,7 +1598,7 @@ $ node negate.js --no-logfile --logfile=test.log --color --no-color
 > Stability: 1.1 - Active development
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 * `content` {string}
@@ -1797,7 +1797,7 @@ console.log(util.stripVTControlCharacters('\u001B[4mvalue\u001B[0m'));
 > Stability: 1.1 - Active development
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 * `format` {string} A text format defined in `util.inspect.colors`.
diff --git a/doc/api/vm.md b/doc/api/vm.md
@@ -59,7 +59,7 @@ executed in specific contexts.
 added: v0.3.1
 changes:
   - version:
-    - REPLACEME
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51244
     description: Added support for
                 `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`.
@@ -968,7 +968,7 @@ const vm = require('node:vm');
 added: v10.10.0
 changes:
   - version:
-    - REPLACEME
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51244
     description: Added support for
                 `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`.
@@ -1036,7 +1036,7 @@ function with the given `params`.
 ## `vm.constants`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 * {Object}
@@ -1046,7 +1046,7 @@ Returns an object containing commonly used constants for VM operations.
 ### `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`
 
 <!-- YAML
-added: REPLACEME
+added: v20.12.0
 -->
 
 > Stability: 1.1 - Active development
@@ -1064,7 +1064,7 @@ For detailed information, see
 added: v0.3.1
 changes:
   - version:
-    - REPLACEME
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51244
     description: Added support for
                  `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`.
@@ -1245,7 +1245,7 @@ vm.measureMemory({ mode: 'detailed', execution: 'eager' })
 added: v0.3.1
 changes:
   - version:
-    - REPLACEME
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51244
     description: Added support for
                 `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`.
@@ -1321,7 +1321,7 @@ console.log(contextObject);
 added: v0.3.1
 changes:
   - version:
-    - REPLACEME
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51244
     description: Added support for
                 `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`.
@@ -1423,7 +1423,7 @@ console.log(contextObject);
 added: v0.3.1
 changes:
   - version:
-    - REPLACEME
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51244
     description: Added support for
                 `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`.
diff --git a/doc/api/webstreams.md b/doc/api/webstreams.md
@@ -1417,7 +1417,7 @@ changes:
 <!-- YAML
 added: v17.0.0
 changes:
-  - version: REPLACEME
+  - version: v20.12.0
     pr-url: https://github.com/nodejs/node/pull/50097
     description: format now accepts `deflate-raw` value.
 -->
@@ -1455,7 +1455,7 @@ changes:
 <!-- YAML
 added: v17.0.0
 changes:
-  - version: REPLACEME
+  - version: v20.12.0
     pr-url: https://github.com/nodejs/node/pull/50097
     description: format now accepts `deflate-raw` value.
 -->
diff --git a/doc/changelogs/CHANGELOG_V20.md b/doc/changelogs/CHANGELOG_V20.md
diff --git a/src/node_version.h b/src/node_version.h
