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

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

CHANGELOG.md

@@ -49,7 +49,8 @@ release.
 <a href="doc/changelogs/CHANGELOG_V21.md#21.0.0">21.0.0</a><br/>
   </td>
   <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/>

doc/api/cli.md

@@ -106,7 +106,9 @@ If this flag is passed, the behavior can still be set to not abort through
 ### `--allow-addons`
 
 <!-- YAML
-added: v21.6.0
+added:
+  - v21.6.0
+  - v20.12.0
 -->
 
 > Stability: 1.1 - Active development
@@ -367,7 +369,9 @@ Currently the support for run-time snapshot is experimental in that:
 ### `--build-snapshot-config`
 
 <!-- YAML
-added: v21.6.0
+added:
+  - v21.6.0
+  - v20.12.0
 -->
 
 > Stability: 1 - Experimental
@@ -667,7 +671,9 @@ of `--enable-source-maps`.
 <!-- YAML
 added: v20.6.0
 changes:
-  - version: v21.7.0
+  - version:
+    - v21.7.0
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51289
     description: Add support to multi-line values.
 -->

doc/api/crypto.md

@@ -3515,6 +3515,7 @@ Both keys must have the same `asymmetricKeyType`, which must be one of `'dh'`
 <!-- YAML
 added:
  - v21.7.0
+ - v20.12.0
 -->
 
 > Stability: 1.2 - Release candidate

doc/api/deprecations.md

@@ -3527,7 +3527,9 @@ deprecated. Get them from `fs.constants` or `fs.promises.constants` instead.
 
 <!-- YAML
 changes:
-  - version: v21.7.0
+  - version:
+    - v21.7.0
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51442
     description: End-of-Life.
   - version:
@@ -3551,6 +3553,7 @@ Please use `value instanceof WebAssembly.Module` instead.
 changes:
   - version:
     - v21.5.0
+    - v20.12.0
     - v18.20.0
     pr-url: https://github.com/nodejs/node/pull/51020
     description: Documentation-only deprecation.
@@ -3568,7 +3571,9 @@ changes:
   - version: REPLACEME
     pr-url: https://github.com/nodejs/node/pull/51880
     description: Runtime deprecation.
-  - version: v21.5.0
+  - version:
+    - v21.5.0
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51077
     description: Documentation-only deprecation.
 -->

doc/api/errors.md

@@ -2372,7 +2372,9 @@ V8 startup snapshot even though Node.js isn't building one.
 ### `ERR_NOT_IN_SINGLE_EXECUTABLE_APPLICATION`
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 The operation cannot be performed when it's not in a single-executable
@@ -2545,7 +2547,9 @@ and HTTP/2 `Server` instances.
 ### `ERR_SINGLE_EXECUTABLE_APPLICATION_ASSET_NOT_FOUND`
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 A key was passed to single executable application APIs to identify an asset,

doc/api/fs.md

@@ -6743,6 +6743,7 @@ value is determined by the `options.encoding` passed to [`fs.readdir()`][] or
 <!-- YAML
 added:
   - v21.4.0
+  - v20.12.0
   - v18.20.0
 -->
 
@@ -6760,6 +6761,7 @@ added:
   - v18.17.0
 deprecated:
   - v21.5.0
+  - v20.12.0
   - v18.20.0
 -->
 

doc/api/http2.md

@@ -2893,7 +2893,9 @@ the given `Buffer` as generated by `http2.getPackedSettings()`.
 ### `http2.performServerHandshake(socket[, options])`
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 * `socket` {stream.Duplex}
@@ -3662,7 +3664,9 @@ will result in a [`TypeError`][] being thrown.
 #### `response.appendHeader(name, value)`
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 * `name` {string}

doc/api/n-api.md

@@ -796,6 +796,7 @@ handle and/or callback scope inside a `napi_callback` is not necessary.
 <!-- YAML
 added:
   - v21.6.0
+  - v20.12.0
   - v18.20.0
 -->
 
@@ -3090,7 +3091,9 @@ The JavaScript `string` type is described in
 #### `node_api_create_property_key_utf16`
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 > Stability: 1 - Experimental

doc/api/net.md

@@ -702,7 +702,9 @@ See [`net.createConnection()`][].
 ### Event: `'connectionAttempt'`
 
 <!-- YAML
-added: v21.6.0
+added:
+  - v21.6.0
+  - v20.12.0
 -->
 
 * `ip` {string} The IP which the socket is attempting to connect to.
@@ -715,7 +717,9 @@ if the family autoselection algorithm is enabled in [`socket.connect(options)`][
 ### Event: `'connectionAttemptFailed'`
 
 <!-- YAML
-added: v21.6.0
+added:
+  - v21.6.0
+  - v20.12.0
 -->
 
 * `ip` {string} The IP which the socket attempted to connect to.
@@ -729,7 +733,9 @@ if the family autoselection algorithm is enabled in [`socket.connect(options)`][
 ### Event: `'connectionAttemptTimeout'`
 
 <!-- YAML
-added: v21.6.0
+added:
+  - v21.6.0
+  - v20.12.0
 -->
 
 * `ip` {string} The IP which the socket attempted to connect to.

doc/api/process.md

@@ -2285,7 +2285,9 @@ debugger. See [Signal Events][].
 ## `process.loadEnvFile(path)`
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 > Stability: 1.1 - Active development

doc/api/single-executable-applications.md

@@ -279,7 +279,9 @@ from the JavaScript main script embedded into the executable.
 #### `sea.isSea()`
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 * Returns: {boolean} Whether this script is running inside a single-executable
@@ -288,7 +290,9 @@ added: v21.7.0
 ### `sea.getAsset(key[, encoding])`
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 This method can be used to retrieve the assets configured to be bundled into the
@@ -306,7 +310,9 @@ An error is thrown when no matching asset can be found.
 ### `sea.getAssetAsBlob(key[, options])`
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 Similar to [`sea.getAsset()`][], but returns the result in a [`Blob`][].
@@ -321,7 +327,9 @@ An error is thrown when no matching asset can be found.
 ### `sea.getRawAsset(key)`
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 This method can be used to retrieve the assets configured to be bundled into the

doc/api/util.md

@@ -1598,7 +1598,9 @@ $ node negate.js --no-logfile --logfile=test.log --color --no-color
 > Stability: 1.1 - Active development
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 * `content` {string}
@@ -1797,7 +1799,9 @@ console.log(util.stripVTControlCharacters('\u001B[4mvalue\u001B[0m'));
 > Stability: 1.1 - Active development
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 * `format` {string | Array} A text format or an Array

doc/api/vm.md

@@ -60,6 +60,7 @@ added: v0.3.1
 changes:
   - version:
     - v21.7.0
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51244
     description: Added support for
                 `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`.
@@ -972,6 +973,7 @@ added: v10.10.0
 changes:
   - version:
     - v21.7.0
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51244
     description: Added support for
                 `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`.
@@ -1039,7 +1041,9 @@ function with the given `params`.
 ## `vm.constants`
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 * {Object}
@@ -1049,7 +1053,9 @@ Returns an object containing commonly used constants for VM operations.
 ### `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`
 
 <!-- YAML
-added: v21.7.0
+added:
+  - v21.7.0
+  - v20.12.0
 -->
 
 > Stability: 1.1 - Active development
@@ -1068,6 +1074,7 @@ added: v0.3.1
 changes:
   - version:
     - v21.7.0
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51244
     description: Added support for
                  `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`.
@@ -1250,6 +1257,7 @@ added: v0.3.1
 changes:
   - version:
     - v21.7.0
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51244
     description: Added support for
                 `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`.
@@ -1326,6 +1334,7 @@ added: v0.3.1
 changes:
   - version:
     - v21.7.0
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51244
     description: Added support for
                 `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`.
@@ -1428,6 +1437,7 @@ added: v0.3.1
 changes:
   - version:
     - v21.7.0
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/51244
     description: Added support for
                 `vm.constants.USE_MAIN_CONTEXT_DEFAULT_LOADER`.

doc/api/webstreams.md

@@ -1430,7 +1430,9 @@ changes:
 <!-- YAML
 added: v17.0.0
 changes:
-  - version: v21.2.0
+  - version:
+    - v21.2.0
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/50097
     description: format now accepts `deflate-raw` value.
 -->
@@ -1468,7 +1470,9 @@ changes:
 <!-- YAML
 added: v17.0.0
 changes:
-  - version: v21.2.0
+  - version:
+    - v21.2.0
+    - v20.12.0
     pr-url: https://github.com/nodejs/node/pull/50097
     description: format now accepts `deflate-raw` value.
 -->