2020-05-26, Version 12.17.0 'Erbium' (LTS)

Notable changes: * [d609881] - http,https: increase server headers timeout (Tim Costa) #30071 PR-URL: #33197
nodejs · May 1, 2020 · d4bda0c · d4bda0c
1 parent cbadd11
commit d4bda0c
Show file tree

Hide file tree

Showing 20 changed files with 454 additions and 72 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -28,7 +28,8 @@ release.
 </tr>
 <tr>
     <td valign="top">
-<b><a href="doc/changelogs/CHANGELOG_V12.md#12.16.3">12.16.3</a></b><br/>
+<b><a href="doc/changelogs/CHANGELOG_V12.md#12.17.0">12.17.0</a></b><br/>
+<a href="doc/changelogs/CHANGELOG_V12.md#12.16.3">12.16.3</a><br/>
 <a href="doc/changelogs/CHANGELOG_V12.md#12.16.2">12.16.2</a><br/>
 <a href="doc/changelogs/CHANGELOG_V12.md#12.16.1">12.16.1</a><br/>
 <a href="doc/changelogs/CHANGELOG_V12.md#12.16.0">12.16.0</a><br/>

diff --git a/doc/api/async_hooks.md b/doc/api/async_hooks.md
@@ -467,7 +467,7 @@ init for PROMISE with id 6, trigger id: 5  # the Promise returned by then()
 #### `async_hooks.executionAsyncResource()`
 
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 * Returns: {Object} The resource representing the current execution.
@@ -868,7 +868,7 @@ for (let i = 0; i < 10; i++) {
 
 ## Class: `AsyncLocalStorage`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 This class is used to create asynchronous state within callbacks and promise
@@ -917,15 +917,15 @@ from each other. It is safe to instantiate this class multiple times.
 
 ### `new AsyncLocalStorage()`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 Creates a new instance of `AsyncLocalStorage`. Store is only provided within a
 `run` method call.
 
 ### `asyncLocalStorage.disable()`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 This method disables the instance of `AsyncLocalStorage`. All subsequent calls
@@ -945,7 +945,7 @@ in the current process.
 
 ### `asyncLocalStorage.getStore()`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 * Returns: {any}
@@ -956,7 +956,7 @@ calling `asyncLocalStorage.run`, it will return `undefined`.
 
 ### `asyncLocalStorage.enterWith(store)`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 * `store` {any}
@@ -998,7 +998,7 @@ asyncLocalStorage.getStore(); // Returns the same object
 
 ### `asyncLocalStorage.run(store, callback[, ...args])`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 * `store` {any}
@@ -1033,7 +1033,7 @@ try {
 
 ### `asyncLocalStorage.exit(callback[, ...args])`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 * `callback` {Function}

diff --git a/doc/api/cli.md b/doc/api/cli.md
@@ -129,7 +129,7 @@ Specify the file name of the CPU profile generated by `--cpu-prof`.
 
 ### `--disable-proto=mode`
 <!--YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 Disable the `Object.prototype.__proto__` property. If `mode` is `delete`, the
@@ -626,7 +626,7 @@ warning will be written to stderr instead.
 
 ### `--report-compact`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 Write reports in a compact format, single-line JSON, more easily consumable
@@ -637,7 +637,7 @@ human consumption.
 <!-- YAML
 added: v11.8.0
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/32242
     description: This option is no longer considered experimental.
   - version: v12.0.0
@@ -652,7 +652,7 @@ Location at which the report will be generated.
 <!-- YAML
 added: v11.8.0
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/32242
     description: This option is no longer considered experimental.
   - version: v12.0.0
@@ -667,7 +667,7 @@ Name of the file to which the report will be written.
 <!-- YAML
 added: v11.8.0
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/32496
     description: This option is no longer considered experimental.
   - version: v12.0.0
@@ -686,7 +686,7 @@ error.
 <!-- YAML
 added: v11.8.0
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/32242
     description: This option is no longer considered experimental.
   - version: v12.0.0
@@ -703,7 +703,7 @@ specified through `--report-signal`.
 <!-- YAML
 added: v11.8.0
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/32242
     description: This option is no longer considered experimental.
   - version: v12.0.0
@@ -719,7 +719,7 @@ Default signal is `SIGUSR2`.
 <!-- YAML
 added: v11.8.0
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/32242
     description: This option is no longer considered experimental.
   - version: v12.0.0
@@ -852,7 +852,7 @@ i.e. invoking `process.exit()`.
 
 ### `--trace-sigint`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 Prints a stack trace on SIGINT.
@@ -938,7 +938,7 @@ See `SSL_CERT_DIR` and `SSL_CERT_FILE`.
 
 ### `--use-largepages=mode`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 Re-map the Node.js static code to large memory pages at startup. If supported on

diff --git a/doc/api/crypto.md b/doc/api/crypto.md
@@ -1232,7 +1232,7 @@ passing keys as strings or `Buffer`s due to improved security features.
 <!-- YAML
 added: v11.6.0
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/31178
     description: Added support for `'dh'`.
   - version: v12.0.0
@@ -2091,7 +2091,7 @@ algorithm names.
 
 ### `crypto.diffieHellman(options)`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 * `options`: {Object}
@@ -2107,7 +2107,7 @@ Both keys must have the same `asymmetricKeyType`, which must be one of `'dh'`
 <!-- YAML
 added: v10.12.0
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/31178
     description: Add support for Diffie-Hellman.
   - version: v12.0.0
@@ -2180,7 +2180,7 @@ a `Promise` for an `Object` with `publicKey` and `privateKey` properties.
 <!-- YAML
 added: v10.12.0
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/31178
     description: Add support for Diffie-Hellman.
   - version: v12.0.0

diff --git a/doc/api/dns.md b/doc/api/dns.md
@@ -202,7 +202,7 @@ is not set to `true`, it returns a `Promise` for an `Object` with `address` and
 ### Supported getaddrinfo flags
 <!-- YAML
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/32183
     description: Added support for the `dns.ALL` flag.
 -->

diff --git a/doc/api/errors.md b/doc/api/errors.md
@@ -1868,7 +1868,7 @@ The context must be a `SecureContext`.
 <a id="ERR_TLS_INVALID_STATE"></a>
 ### `ERR_TLS_INVALID_STATE`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 The TLS socket must be connected and securily established. Ensure the 'secure'

diff --git a/doc/api/events.md b/doc/api/events.md
@@ -362,7 +362,7 @@ Its `name` property is set to `'MaxListenersExceededWarning'`.
 
 ### `EventEmitter.errorMonitor`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 This symbol shall be used to install a listener for only monitoring `'error'`

diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -1675,7 +1675,7 @@ changes:
   - version: v2.3.0
     pr-url: https://github.com/nodejs/node/pull/1845
     description: The passed `options` object can be a string now.
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/29083
     description: The `fs` options allow overriding the used `fs`
                  implementation.
@@ -1778,8 +1778,8 @@ changes:
   - version: v2.3.0
     pr-url: https://github.com/nodejs/node/pull/1845
     description: The passed `options` object can be a string now.
-  - version: REPLACEME
-    pr-url: https://github.com/nodejs/node/pull/REPLACEME
+  - version: v12.17.0
+    pr-url: https://github.com/nodejs/node/pull/v12.17.0
     description: The `fs` options allow overriding the used `fs`
                  implementation.
 -->
@@ -2439,7 +2439,7 @@ Synchronous lstat(2).
 <!-- YAML
 added: v0.1.8
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/31530
     description: In `recursive` mode, the callback now receives the first
                  created path as an argument.
@@ -2501,7 +2501,7 @@ See also: mkdir(2).
 <!-- YAML
 added: v0.1.21
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/31530
     description: In `recursive` mode, the first created path is returned now.
   - version: v10.12.0
@@ -2785,9 +2785,9 @@ a `Promise` for an `Object` with `bytesRead` and `buffer` properties.
 
 ## `fs.read(fd, [options,] callback)`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/31402
     description: Options object can be passed in
                  to make Buffer, offset, length and position optional
@@ -3083,9 +3083,9 @@ this API: [`fs.read()`][].
 
 ## `fs.readSync(fd, buffer, [options])`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 changes:
-  - version: REPLACEME
+  - version: v12.17.0
     pr-url: https://github.com/nodejs/node/pull/32460
     description: Options object can be passed in
                  to make offset, length and position optional
@@ -3109,7 +3109,7 @@ this API: [`fs.read()`][].
 
 ## `fs.readv(fd, buffers[, position], callback)`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 * `fd` {integer}
@@ -3132,7 +3132,7 @@ The callback will be given three arguments: `err`, `bytesRead`, and
 
 ## `fs.readvSync(fd, buffers[, position])`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 * `fd` {integer}
@@ -4460,7 +4460,7 @@ property that is a reference to the passed in `buffer` argument.
 
 #### `filehandle.read(options)`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 * `options` {Object}
   * `buffer` {Buffer|Uint8Array} **Default:** `Buffer.alloc(16384)`
@@ -4495,7 +4495,7 @@ of the file.
 
 #### `filehandle.readv(buffers[, position])`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 * `buffers` {ArrayBufferView[]}

diff --git a/doc/api/modules.md b/doc/api/modules.md
@@ -1026,7 +1026,7 @@ import('fs').then((esmFS) => {
 
 ## Source Map V3 Support
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 > Stability: 1 - Experimental
@@ -1045,7 +1045,7 @@ const { findSourceMap, SourceMap } = require('module');
 
 ### `module.findSourceMap(path[, error])`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 * `path` {string}
@@ -1063,7 +1063,7 @@ will be associated with the `error` instance along with the `path`.
 
 ### Class: `module.SourceMap`
 <!-- YAML
-added: REPLACEME
+added: v12.17.0
 -->
 
 #### `new SourceMap(payload)`