2021-10-19, Version 17.0.0 (Current)

Notable changes: Deprecations and Removals: PR-URL: #40119
nodejs · Oct 5, 2021 · a99d569 · a99d569
1 parent 0d2b6ac
commit a99d569
Show file tree

Hide file tree

Showing 32 changed files with 154 additions and 46 deletions.
diff --git a/CHANGELOG.md b/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**
@@ -27,11 +28,15 @@ release.
 
 <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.10.0">16.10.0</a></b><br/>
 <a href="doc/changelogs/CHANGELOG_V16.md#16.9.1">16.9.1</a><br/>

diff --git a/doc/api/cli.md b/doc/api/cli.md
@@ -623,7 +623,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.

diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
@@ -2707,7 +2707,7 @@ Use `fs.rm(path, { recursive: true, force: true })`,
 ### DEP0148: Folder mappings in `"exports"` (trailing `"/"`)
 <!-- YAML
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/40121
     description: End-of-Life.
   - version: v16.0.0
@@ -2795,7 +2795,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
@@ -2826,7 +2826,7 @@ 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: v16.10.0
@@ -2843,7 +2843,7 @@ for package `"exports"` and `"imports"` pattern resolutions.
 ### DEP0156: `.aborted` property and `'abort'`, `'aborted'` event in `http`
 <!-- YAML
 changes:
-  - version: REPLACEME
+  - version: v17.0.0
     pr-url: https://github.com/nodejs/node/pull/36670
     description: Documentation-only deprecation.
 -->

diff --git a/doc/api/dgram.md b/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`.

diff --git a/doc/api/dns.md b/doc/api/dns.md
@@ -172,7 +172,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

diff --git a/doc/api/esm.md b/doc/api/esm.md
@@ -8,7 +8,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`,

diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -232,7 +232,7 @@ try {
 
 #### `filehandle.createReadStream([options])`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * `options` {Object}
@@ -298,7 +298,7 @@ fd.createReadStream({ start: 90, end: 99 });
 
 #### `filehandle.createWriteStream([options])`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * `options` {Object}
@@ -395,7 +395,7 @@ number of bytes read is zero.
 
 #### `filehandle.readableWebStream()`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental

diff --git a/doc/api/globals.md b/doc/api/globals.md
@@ -383,7 +383,7 @@ added: v0.0.1
 
 ## `DOMException`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 <!-- type=global -->

diff --git a/doc/api/http.md b/doc/api/http.md
@@ -407,7 +407,7 @@ body which has been transmitted are equal or not.
 ### Event: `'abort'`
 <!-- YAML
 added: v1.4.1
-deprecated: REPLACEME
+deprecated: v17.0.0
 -->
 
 > Stability: 0 - Deprecated. Listen for the `'close'` event instead.
@@ -648,7 +648,7 @@ in the response to be dropped and the socket to be destroyed.
 ### `request.aborted`
 <!-- YAML
 added: v0.11.14
-deprecated: REPLACEME
+deprecated: v17.0.0
 changes:
   - version: v11.0.0
     pr-url: https://github.com/nodejs/node/pull/20230
@@ -1994,7 +1994,7 @@ may be reused multiple times in case of keep-alive.
 ### Event: `'aborted'`
 <!-- YAML
 added: v0.3.8
-deprecated: REPLACEME
+deprecated: v17.0.0
 -->
 
 > Stability: 0 - Deprecated. Listen for `'close'` event instead.
@@ -2011,7 +2011,7 @@ Indicates that the underlying connection was closed.
 ### `message.aborted`
 <!-- YAML
 added: v10.1.0
-deprecated: REPLACEME
+deprecated: v17.0.0
 -->
 
 > Stability: 0 - Deprecated. Check `message.destroyed` from {stream.Readable}.

diff --git a/doc/api/readline.md b/doc/api/readline.md
@@ -536,14 +536,14 @@ line prompts are included in the calculations.
 
 ## Promises API
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental
 
 ### Class: `readlinePromises.Interface`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * Extends: {readline.InterfaceConstructor}
@@ -556,7 +556,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
@@ -602,12 +602,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.
@@ -616,7 +616,7 @@ added: REPLACEME
 
 #### `rl.clearLine(dir)`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * `dir` {integer}
@@ -633,7 +633,7 @@ was passed to the constructor.
 
 #### `rl.clearScreenDown()`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * Returns: this
@@ -646,7 +646,7 @@ was passed to the constructor.
 
 #### `rl.commit()`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * Returns: {Promise}
@@ -656,7 +656,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}
@@ -670,7 +670,7 @@ was passed to the constructor.
 
 #### `rl.moveCursor(dx, dy)`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * `dx` {integer}
@@ -685,7 +685,7 @@ was passed to the constructor.
 
 #### `rl.rollback()`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * Returns: this
@@ -695,7 +695,7 @@ sending it to the associated `stream`.
 
 ### `readlinePromises.createInterface(options)`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * `options` {Object}
@@ -797,7 +797,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`.
 -->

diff --git a/doc/api/stream.md b/doc/api/stream.md
@@ -2081,7 +2081,7 @@ for performance reasons.
 
 ### `stream.Readable.fromWeb(readableStream[, options])`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental
@@ -2108,7 +2108,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
@@ -2118,7 +2118,7 @@ added: REPLACEME
 
 ### `stream.Writable.fromWeb(writableStream[, options])`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental
@@ -2133,7 +2133,7 @@ added: REPLACEME
 
 ### `stream.Writable.toWeb(streamWritable)`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental
@@ -2171,7 +2171,7 @@ A utility method for creating duplex streams.
 
 ### `stream.Duplex.fromWeb(pair[, options])`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental
@@ -2190,7 +2190,7 @@ added: REPLACEME
 
 ### `stream.Duplex.toWeb(streamDuplex)`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 > Stability: 1 - Experimental

diff --git a/doc/api/url.md b/doc/api/url.md
@@ -1386,7 +1386,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

diff --git a/doc/api/util.md b/doc/api/util.md
@@ -1113,7 +1113,7 @@ doSomething[kCustomPromisifiedSymbol] = (foo) => {
 
 ## `util.stripVTControlCharacters(str)`
 <!-- YAML
-added: REPLACEME
+added: v17.0.0
 -->
 
 * `str` {string}