2021-10-19, Version 17.0.0 (Current)

Notable changes:

Deprecations and Removals:

PR-URL: #40119

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 Select a Node.js version below to view the changelog history:
 
+* [Node.js 17](doc/changelogs/CHANGELOG_V17.md) **Current**
 * [Node.js 16](doc/changelogs/CHANGELOG_V16.md) **Current**
 * [Node.js 15](doc/changelogs/CHANGELOG_V15.md) End-of-Life
 * [Node.js 14](doc/changelogs/CHANGELOG_V14.md) **Long Term Support**
@@ -26,11 +27,15 @@ release.
 <!--lint disable maximum-line-length-->
 <table>
 <tr>
+  <th title="Current"><a href="doc/changelogs/CHANGELOG_V17.md">17</a><sup>Current</sup></th>
   <th title="Current"><a href="doc/changelogs/CHANGELOG_V16.md">16</a><sup>Current</sup></th>
   <th title="LTS Until 2023-04"><a href="doc/changelogs/CHANGELOG_V14.md">14</a><sup>LTS</sup></th>
   <th title="LTS Until 2022-04"><a href="doc/changelogs/CHANGELOG_V12.md">12</a><sup>LTS</sup></th>
 </tr>
 <tr>
+  <td valign="top">
+<b><a href="doc/changelogs/CHANGELOG_V17.md#17.0.0">17.0.0</a></b><br/>
+    </td>
     <td valign="top">
 <b><a href="doc/changelogs/CHANGELOG_V16.md#16.9.1">16.9.1</a></b><br/>
 <a href="doc/changelogs/CHANGELOG_V16.md#16.9.0">16.9.0</a><br/>

doc/api/cli.md

@@ -600,7 +600,7 @@ This option is a no-op. It is kept for compatibility.
 
 ### `--no-addons`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 Disable the `node-addons` exports condition as well as disable loading
@@ -616,7 +616,7 @@ Silence deprecation warnings.
 
 ### `--no-extra-info-on-fatal-exception`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 Hide extra information on fatal exception that causes exit.
@@ -631,7 +631,7 @@ dynamically when `async_hooks` is enabled.
 
 ### `--no-global-search-paths`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 Do not search modules from global paths like `$HOME/.node_modules` and

doc/api/crypto.md

@@ -3375,7 +3375,7 @@ generateKey('hmac', { length: 64 }, (err, key) => {
 <!-- YAML
 added: v10.12.0
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/39927
     description: Add ability to define `RSASSA-PSS-params` sequence parameters
                  for RSA-PSS keys pairs.
@@ -3486,7 +3486,7 @@ a `Promise` for an `Object` with `publicKey` and `privateKey` properties.
 <!-- YAML
 added: v10.12.0
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/39927
     description: Add ability to define `RSASSA-PSS-params` sequence parameters
                  for RSA-PSS keys pairs.

doc/api/deprecations.md

@@ -2789,7 +2789,7 @@ deprecated and should no longer be used.
 ### DEP0153: `dns.lookup` and `dnsPromises.lookup` options type coercion
 <!-- YAML
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/39793
     description: Runtime deprecation.
   - version: v16.8.0
@@ -2807,7 +2807,7 @@ option, or a non-nullish non-boolean value for `verbatim` option in
 ### DEP0154: RSA-PSS generate key pair options
 <!-- YAML
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/39927
     description: Documentation-only deprecation.
 -->
@@ -2820,10 +2820,10 @@ and `'mgf1HashAlgorithm'`.
 ### DEP0155: Trailing slashes in pattern specifier resolutions
 <!-- YAML
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/40117
     description: Runtime deprecation.
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/40039
     description: Documentation-only deprecation
                  with `--pending-deprecation` support.

doc/api/dgram.md

@@ -468,7 +468,7 @@ if the socket is not connected.
 <!-- YAML
 added: v0.1.99
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/39190
     description: The `address` parameter now only accepts a `string`, `null`
                  or `undefined`.

doc/api/dns.md

@@ -170,7 +170,7 @@ section if a custom port is used.
 <!-- YAML
 added: v0.1.90
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/39987
     description: The `verbatim` options defaults to `true` now.
   - version: v8.5.0

doc/api/errors.md

@@ -1030,7 +1030,7 @@ The [debugger][] timed out waiting for the required host/port to be free.
 <a id="ERR_DLOPEN_DISABLED"></a>
 ### `ERR_DLOPEN_DISABLED`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 Loading native addons has been disabled using [`--no-addons`][].

doc/api/esm.md

@@ -6,7 +6,7 @@
 added: v8.5.0
 changes:
   - version:
-    - REPLACEME
+    - v17.0.0
     pr-url: https://github.com/nodejs/node/pull/37468
     description:
       Consolidate loader hooks, removed `getFormat`, `getSource`,

doc/api/fs.md

@@ -302,7 +302,7 @@ number of bytes read is zero.
 
 #### `filehandle.readableWebStream()`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental
@@ -1933,10 +1933,10 @@ behavior is similar to `cp dir1/ dir2/`.
 <!-- YAML
 added: v0.1.31
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/40013
     description: The `fs` option does not need `open` method if an `fd` was provided.
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/40013
     description: The `fs` option does not need `close` method if `autoClose` is `false`.
   - version:
@@ -2058,10 +2058,10 @@ If `options` is a string, then it specifies the encoding.
 <!-- YAML
 added: v0.1.31
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/40013
     description: The `fs` option does not need `open` method if an `fd` was provided.
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/40013
     description: The `fs` option does not need `close` method if `autoClose` is `false`.
   - version:

doc/api/globals.md

@@ -382,7 +382,7 @@ added: v0.0.1
 
 ## `DOMException`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 <!-- type=global -->

doc/api/http.md

@@ -1354,7 +1354,7 @@ explicitly.
 
 ### `server.maxRequestsPerSocket`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * {number} Requests per socket. **Default:** null (no limit)

doc/api/readline.md

@@ -532,12 +532,12 @@ line prompts are included in the calculations.
 
 ## Promises API
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 ### Class: `readlinePromises.Interface`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * Extends: {readline.InterfaceConstructor}
@@ -550,7 +550,7 @@ and is read from, the `input` stream.
 
 #### `rl.question(query[, options])`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * `query` {string} A statement or query to write to `output`, prepended to the
@@ -596,12 +596,12 @@ setTimeout(() => ac.abort(), 10000);
 
 ### Class: `readlinePromises.Readline`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 #### `new readlinePromises.Readline(stream[, options])`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * `stream` {stream.Writable} A [TTY][] stream.
@@ -610,7 +610,7 @@ added: REPLACEME
 
 #### `rl.clearLine(dir)`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * `dir` {integer}
@@ -627,7 +627,7 @@ was passed to the constructor.
 
 #### `rl.clearScreenDown()`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * Returns: this
@@ -640,7 +640,7 @@ was passed to the constructor.
 
 #### `rl.commit()`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * Returns: {Promise}
@@ -650,7 +650,7 @@ The `rl.commit()` method sends all the pending actions to the associated
 
 #### `rl.cursorTo(x[, y])`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * `x` {integer}
@@ -664,7 +664,7 @@ was passed to the constructor.
 
 #### `rl.moveCursor(dx, dy)`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * `dx` {integer}
@@ -679,7 +679,7 @@ was passed to the constructor.
 
 #### `rl.rollback()`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * Returns: this
@@ -689,7 +689,7 @@ sending it to the associated `stream`.
 
 ### `readlinePromises.createInterface(options)`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * `options` {Object}
@@ -791,7 +791,7 @@ added: v0.1.104
 <!-- YAML
 added: v0.1.104
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/37947
     description: The class `readline.Interface` now inherits from `Interface`.
 -->

doc/api/stream.md

@@ -2079,7 +2079,7 @@ for performance reasons.
 
 ### `stream.Readable.fromWeb(readableStream[, options])`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental
@@ -2106,7 +2106,7 @@ Returns whether the stream has been read from or cancelled.
 
 ### `stream.Readable.toWeb(streamReadable)`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental
@@ -2116,7 +2116,7 @@ added: REPLACEME
 
 ### `stream.Writable.fromWeb(writableStream[, options])`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental
@@ -2131,7 +2131,7 @@ added: REPLACEME
 
 ### `stream.Writable.toWeb(streamWritable)`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental
@@ -2169,7 +2169,7 @@ A utility method for creating duplex streams.
 
 ### `stream.Duplex.fromWeb(pair[, options])`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental
@@ -2188,7 +2188,7 @@ added: REPLACEME
 
 ### `stream.Duplex.toWeb(streamDuplex)`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental

doc/api/url.md

@@ -1384,7 +1384,7 @@ forward-slash characters (`/`) are required following the colon in the
 <!-- YAML
 added: v0.1.25
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/38631
     description: Now throws an `ERR_INVALID_URL` exception when Punycode
                  conversion of a hostname introduces changes that could cause