From d9ebc04e9bf31bf45c49875c1a689b6401e07009 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C3=ABl=20Zasso?= Date: Sat, 4 Sep 2021 15:29:35 +0200 Subject: [PATCH] 2021-09-28, Version 14.18.0 'Fermium' (LTS) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Notable changes: assert: * change status of legacy asserts (James M Snell) https://github.com/nodejs/node/pull/38113 buffer: * (SEMVER-MINOR) introduce Blob (James M Snell) https://github.com/nodejs/node/pull/36811 * (SEMVER-MINOR) add base64url encoding option (Filip Skokan) https://github.com/nodejs/node/pull/36952 child_process: * (SEMVER-MINOR) allow `options.cwd` receive a URL (Khaidi Chu) https://github.com/nodejs/node/pull/38862 * (SEMVER-MINOR) add timeout to spawn and fork (Nitzan Uziely) https://github.com/nodejs/node/pull/37256 * (SEMVER-MINOR) allow promisified exec to be cancel (Carlos Fuentes) https://github.com/nodejs/node/pull/34249 * (SEMVER-MINOR) add 'overlapped' stdio flag (Thiago Padilha) https://github.com/nodejs/node/pull/29412 cli: * (SEMVER-MINOR) add -C alias for --conditions flag (Guy Bedford) https://github.com/nodejs/node/pull/38755 * (SEMVER-MINOR) add --node-memory-debug option (Anna Henningsen) https://github.com/nodejs/node/pull/35537 dns: * (SEMVER-MINOR) add "tries" option to Resolve options (Luan Devecchi) https://github.com/nodejs/node/pull/39610 * (SEMVER-MINOR) allow `--dns-result-order` to change default dns verbatim (Ouyang Yadong) https://github.com/nodejs/node/pull/38099 doc: * (SEMVER-MINOR) add missing change to resolver ctor (Luan Devecchi) https://github.com/nodejs/node/pull/39610 * refactor fs docs structure (James M Snell) https://github.com/nodejs/node/pull/37170 errors: * (SEMVER-MINOR) remove experimental from --enable-source-maps (Benjamin Coe) https://github.com/nodejs/node/pull/37362 esm: * deprecate legacy main lookup for modules (Guy Bedford) https://github.com/nodejs/node/pull/36918 fs: * (SEMVER-MINOR) allow empty string for temp directory prefix (Voltrex) https://github.com/nodejs/node/pull/39028 * (SEMVER-MINOR) allow no-params fsPromises fileHandle read (Nitzan Uziely) https://github.com/nodejs/node/pull/38287 * (SEMVER-MINOR) add support for async iterators to `fsPromises.writeFile` (HiroyukiYagihashi) https://github.com/nodejs/node/pull/37490 * improve fsPromises readFile performance (Nitzan Uziely) https://github.com/nodejs/node/pull/37608 * (SEMVER-MINOR) add fsPromises.watch() (James M Snell) https://github.com/nodejs/node/pull/37179 * (SEMVER-MINOR) allow `position` parameter to be a `BigInt` in read and readSync (Darshan Sen) https://github.com/nodejs/node/pull/36190 http2: * (SEMVER-MINOR) add support for sensitive headers (Anna Henningsen) https://github.com/nodejs/node/pull/34145 * (SEMVER-MINOR) allow setting the local window size of a session (Yongsheng Zhang) https://github.com/nodejs/node/pull/35978 inspector: * mark as stable (Gireesh Punathil) https://github.com/nodejs/node/pull/37748 module: * (SEMVER-MINOR) add support for `URL` to `import.meta.resolve` (Antoine du Hamel) https://github.com/nodejs/node/pull/38587 * (SEMVER-MINOR) add support for `node:`‑prefixed `require(…)` calls (ExE Boss) https://github.com/nodejs/node/pull/37246 net: * (SEMVER-MINOR) introduce net.BlockList (James M Snell) https://github.com/nodejs/node/pull/34625 node-api: * (SEMVER-MINOR) allow retrieval of add-on file name (Gabriel Schulhof) https://github.com/nodejs/node/pull/37195 os: * (SEMVER-MINOR) add os.devNull (Luigi Pinca) https://github.com/nodejs/node/pull/38569 perf_hooks: * (SEMVER-MINOR) introduce createHistogram (James M Snell) https://github.com/nodejs/node/pull/37155 process: * (SEMVER-MINOR) add api to enable source-maps programmatically (legendecas) https://github.com/nodejs/node/pull/39085 * (SEMVER-MINOR) add `'worker'` event (James M Snell) https://github.com/nodejs/node/pull/38659 * (SEMVER-MINOR) add direct access to rss without iterating pages (Adrien Maret) https://github.com/nodejs/node/pull/34291 readline: * (SEMVER-MINOR) add AbortSignal support to interface (Nitzan Uziely) https://github.com/nodejs/node/pull/37932 * (SEMVER-MINOR) add support for the AbortController to the question method (Mattias Runge-Broberg) https://github.com/nodejs/node/pull/33676 * (SEMVER-MINOR) add history event and option to set initial history (Mattias Runge-Broberg) https://github.com/nodejs/node/pull/33662 repl: * (SEMVER-MINOR) add auto‑completion for `node:`‑prefixed `require(…)` calls (ExE Boss) https://github.com/nodejs/node/pull/37246 src: * (SEMVER-MINOR) call overload ctor from the original ctor (Darshan Sen) https://github.com/nodejs/node/pull/39768 * (SEMVER-MINOR) add a constructor overload for CallbackScope (Darshan Sen) https://github.com/nodejs/node/pull/39768 * (SEMVER-MINOR) allow to negate boolean CLI flags (Michaël Zasso) https://github.com/nodejs/node/pull/39023 * (SEMVER-MINOR) add --heapsnapshot-near-heap-limit option (Joyee Cheung) https://github.com/nodejs/node/pull/33010 * (SEMVER-MINOR) add way to get IsolateData and allocator from Environment (Anna Henningsen) https://github.com/nodejs/node/pull/36441 * (SEMVER-MINOR) allow preventing SetPrepareStackTraceCallback (Shelley Vohr) https://github.com/nodejs/node/pull/36447 * (SEMVER-MINOR) add maybe versions of EmitExit and EmitBeforeExit (Anna Henningsen) https://github.com/nodejs/node/pull/35486 stream: * (SEMVER-MINOR) add readableDidRead if has been read from (Robert Nagy) https://github.com/nodejs/node/pull/39589 * (SEMVER-MINOR) pipeline accept Buffer as a valid first argument (Nitzan Uziely) https://github.com/nodejs/node/pull/37739 tls: * (SEMVER-MINOR) allow reading data into a static buffer (Andrey Pechkurov) https://github.com/nodejs/node/pull/35753 tools: * (SEMVER-MINOR) add `Worker` to type-parser (James M Snell) https://github.com/nodejs/node/pull/38659 url: * (SEMVER-MINOR) expose urlToHttpOptions utility (Yongsheng Zhang) https://github.com/nodejs/node/pull/35960 util: * (SEMVER-MINOR) expose toUSVString (Robert Nagy) https://github.com/nodejs/node/pull/39814 v8: * (SEMVER-MINOR) implement v8.stopCoverage() (Joyee Cheung) https://github.com/nodejs/node/pull/33807 * (SEMVER-MINOR) implement v8.takeCoverage() (Joyee Cheung) https://github.com/nodejs/node/pull/33807 worker: * (SEMVER-MINOR) add setEnvironmentData/getEnvironmentData (James M Snell) https://github.com/nodejs/node/pull/37486 PR-URL: https://github.com/nodejs/node/pull/39990 --- CHANGELOG.md | 3 +- doc/api/assert.md | 40 +-- doc/api/buffer.md | 32 ++- doc/api/child_process.md | 48 +++- doc/api/cli.md | 16 +- doc/api/deprecations.md | 4 +- doc/api/dns.md | 12 +- doc/api/errors.md | 8 +- doc/api/esm.md | 8 +- doc/api/fs.md | 28 +- doc/api/http.md | 4 +- doc/api/http2.md | 8 +- doc/api/https.md | 8 +- doc/api/modules.md | 4 +- doc/api/n-api.md | 1 + doc/api/net.md | 48 +++- doc/api/os.md | 4 +- doc/api/perf_hooks.md | 16 +- doc/api/process.md | 12 +- doc/api/readline.md | 16 +- doc/api/stream.md | 4 +- doc/api/tls.md | 20 +- doc/api/url.md | 4 +- doc/api/util.md | 4 +- doc/api/v8.md | 2 + doc/api/worker_threads.md | 16 +- doc/changelogs/CHANGELOG_V14.md | 492 ++++++++++++++++++++++++++++++++ 27 files changed, 758 insertions(+), 104 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 52280634debe10..0a9a84011b0368 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -51,7 +51,8 @@ release. 16.0.0
-14.17.6
+14.18.0
+14.17.6
14.17.5
14.17.4
14.17.3
diff --git a/doc/api/assert.md b/doc/api/assert.md index 5215ea06816e3a..3848cde97f65e8 100644 --- a/doc/api/assert.md +++ b/doc/api/assert.md @@ -456,7 +456,9 @@ An alias of [`assert.ok()`][]. @@ -1127,7 +1129,9 @@ assert.doesNotThrow( @@ -1635,7 +1641,9 @@ instead of the [`AssertionError`][]. > Stability: 1 - Experimental @@ -458,7 +462,9 @@ multiple worker threads. ### `new buffer.Blob([sources[, options]])` * Returns: {Promise} @@ -498,14 +506,18 @@ the `Blob` data. ### `blob.size` The total size of the `Blob` in bytes. ### `blob.slice([start, [end, [type]]])` * `start` {number} The starting index. @@ -526,7 +538,9 @@ Returns a new `ReadableStream` that allows the content of the `Blob` to be read. ### `blob.text()` * Returns: {Promise} @@ -536,7 +550,9 @@ UTF-8 string. ### `blob.type` * Type: {string} diff --git a/doc/api/child_process.md b/doc/api/child_process.md index 3f67459effd8ec..340a0f0577733d 100644 --- a/doc/api/child_process.md +++ b/doc/api/child_process.md @@ -146,7 +146,9 @@ exec('"my script.cmd" a b', (err, stdout, stderr) => { Set the default value of `verbatim` in [`dns.lookup()`][] and @@ -213,7 +215,9 @@ against FIPS-compatible OpenSSL.) @@ -363,7 +367,9 @@ be added. ### `--heapsnapshot-near-heap-limit=max_count` > Stability: 1 - Experimental @@ -647,7 +653,9 @@ Silence all process warnings (including deprecations). ### `--node-memory-debug` Enable extra debug checks for memory leaks in Node.js internals. This is diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md index 7d610d04bae2f5..0ab773dcb04825 100644 --- a/doc/api/deprecations.md +++ b/doc/api/deprecations.md @@ -2760,7 +2760,9 @@ changes: - version: v16.0.0 pr-url: https://github.com/nodejs/node/pull/37206 description: Runtime deprecation. - - version: v15.8.0 + - version: + - v15.8.0 + - v14.18.0 pr-url: https://github.com/nodejs/node/pull/36918 description: Documentation-only deprecation with `--pending-deprecation` support. diff --git a/doc/api/dns.md b/doc/api/dns.md index ef90e15a04dc4b..1a5ecd80b9f3b3 100644 --- a/doc/api/dns.md +++ b/doc/api/dns.md @@ -97,7 +97,9 @@ The following methods from the `dns` module are available: * `order` {string} must be `'ipv4first'` or `'verbatim'`. @@ -1168,7 +1172,9 @@ is one of the [DNS error codes](). ### `dnsPromises.setDefaultResultOrder(order)` * `order` {string} must be `'ipv4first'` or `'verbatim'`. diff --git a/doc/api/errors.md b/doc/api/errors.md index de754ec81dd782..b0b0753f400401 100644 --- a/doc/api/errors.md +++ b/doc/api/errors.md @@ -1003,7 +1003,9 @@ An unknown Diffie-Hellman group name was given. See ### `ERR_CRYPTO_UNSUPPORTED_OPERATION` An attempt to invoke an unsupported crypto operation was made. @@ -1668,7 +1670,9 @@ An IP address is not valid. ### `ERR_INVALID_MODULE` An attempt was made to load a module that does not exist or was otherwise not diff --git a/doc/api/esm.md b/doc/api/esm.md index 32beab664dc885..9ec67330000907 100644 --- a/doc/api/esm.md +++ b/doc/api/esm.md @@ -217,7 +217,9 @@ added: - v14.13.1 - v12.20.0 changes: - - version: v16.0.0 + - version: + - v16.0.0 + - v14.18.0 pr-url: https://github.com/nodejs/node/pull/37246 description: Added `node:` import support to `require(...)`. --> @@ -297,7 +299,9 @@ added: - v13.9.0 - v12.16.2 changes: - - version: v16.2.0 + - version: + - v16.2.0 + - v14.18.0 pr-url: https://github.com/nodejs/node/pull/38587 description: Add support for WHATWG `URL` object to `parentURL` parameter. --> diff --git a/doc/api/fs.md b/doc/api/fs.md index 3facd3b4b0586a..fb16501033978e 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -636,7 +636,9 @@ the end of the file. @@ -1389,7 +1393,9 @@ The `atime` and `mtime` arguments follow these rules: ### `fsPromises.watch(filename[, options])` * `filename` {string|Buffer|URL} @@ -1440,12 +1446,14 @@ All the [caveats][] for `fs.watch()` also apply to `fsPromises.watch()`. diff --git a/doc/api/http.md b/doc/api/http.md index 3fb6d398330340..d059469de294c6 100644 --- a/doc/api/http.md +++ b/doc/api/http.md @@ -2863,7 +2863,9 @@ This can be overridden for servers and client requests by passing the * `windowSize` {number} @@ -2625,7 +2627,9 @@ the given `Buffer` as generated by `http2.getPackedSettings()`. ### `http2.sensitiveHeaders` * {symbol} diff --git a/doc/api/https.md b/doc/api/https.md index 98a845994a78fa..a2dbeb473a994d 100644 --- a/doc/api/https.md +++ b/doc/api/https.md @@ -251,13 +251,15 @@ Global instance of [`https.Agent`][] for all HTTPS client requests. diff --git a/doc/api/n-api.md b/doc/api/n-api.md index 6a32139283f4aa..24963af7f90878 100644 --- a/doc/api/n-api.md +++ b/doc/api/n-api.md @@ -5982,6 +5982,7 @@ This API may only be called from the main thread. diff --git a/doc/api/net.md b/doc/api/net.md index 1b662f0502f1bc..6d5487b6748441 100644 --- a/doc/api/net.md +++ b/doc/api/net.md @@ -58,7 +58,9 @@ net.createServer().listen( ## Class: `net.BlockList` The `BlockList` object can be used with some network APIs to specify rules for @@ -67,7 +69,9 @@ IP subnets. ### `blockList.addAddress(address[, type])` * `address` {string|net.SocketAddress} An IPv4 or IPv6 address. @@ -77,7 +81,9 @@ Adds a rule to block the given IP address. ### `blockList.addRange(start, end[, type])` * `start` {string|net.SocketAddress} The starting IPv4 or IPv6 address in the @@ -90,7 +96,9 @@ Adds a rule to block a range of IP addresses from `start` (inclusive) to ### `blockList.addSubnet(net, prefix[, type])` * `net` {string|net.SocketAddress} The network IPv4 or IPv6 address. @@ -103,7 +111,9 @@ Adds a rule to block a range of IP addresses specified as a subnet mask. ### `blockList.check(address[, type])` * `address` {string|net.SocketAddress} The IP address to check @@ -130,7 +140,9 @@ console.log(blockList.check('::ffff:123.123.123.123', 'ipv6')); // Prints: true ### `blockList.rules` * Type: {string[]} @@ -139,11 +151,15 @@ The list of rules added to the blocklist. ## Class: `net.SocketAddress` ### `new net.SocketAddress([options])` * `options` {Object} @@ -156,28 +172,36 @@ added: v15.14.0 ### `socketaddress.address` * Type {string} ### `socketaddress.family` * Type {string} Either `'ipv4'` or `'ipv6'`. ### `socketaddress.flowlabel` * Type {number} ### `socketaddress.port` * Type {number} diff --git a/doc/api/os.md b/doc/api/os.md index 85469a56293cc6..990d4cce9e45b3 100644 --- a/doc/api/os.md +++ b/doc/api/os.md @@ -124,7 +124,9 @@ are always 0. ## `os.devNull` * {string} diff --git a/doc/api/perf_hooks.md b/doc/api/perf_hooks.md index 9a93c2293cee80..553cf3dc799c00 100644 --- a/doc/api/perf_hooks.md +++ b/doc/api/perf_hooks.md @@ -776,7 +776,9 @@ performance.mark('meow'); ## `perf_hooks.createHistogram([options])` * `options` {Object} @@ -935,19 +937,25 @@ implement the `enable()` and `disable()` methods. ## Class: `RecordableHistogram extends Histogram` ### `histogram.record(val)` * `val` {number|bigint} The amount to record in the histogram. ### `histogram.recordDelta()` Calculates the amount of time (in nanoseconds) that has passed since the diff --git a/doc/api/process.md b/doc/api/process.md index 67a6c6ce0f1f41..91b23a3f31d704 100644 --- a/doc/api/process.md +++ b/doc/api/process.md @@ -628,7 +628,9 @@ The `*-deprecation` command-line flags only affect warnings that use the name ### Event: `'worker'` * `worker` {Worker} The {Worker} that was created. @@ -2220,7 +2222,9 @@ program memory allocations. ## `process.memoryUsage.rss()` * Returns: {integer} @@ -3253,7 +3257,9 @@ This feature is not available in [`Worker`][] threads. ## `process.setSourceMapsEnabled(val)` > Stability: 1 - Experimental diff --git a/doc/api/readline.md b/doc/api/readline.md index f59ec410095225..6c782fcc2d4364 100644 --- a/doc/api/readline.md +++ b/doc/api/readline.md @@ -118,7 +118,9 @@ rl.on('line', (input) => { ### Event: `'history'` The `'history'` event is emitted whenever the history array has changed. @@ -466,7 +468,9 @@ asynchronous iteration may result in missed lines. @@ -921,10 +925,14 @@ the current position of the cursor down. > Stability: 1 - Experimental diff --git a/doc/api/tls.md b/doc/api/tls.md index 6926b7cda0c66b..ccd1bab90e9d39 100644 --- a/doc/api/tls.md +++ b/doc/api/tls.md @@ -1416,17 +1416,19 @@ being issued by trusted CA (`options.ca`). * `url` {URL} The [WHATWG URL][] object to convert to an options object. diff --git a/doc/api/util.md b/doc/api/util.md index ac768c38c7eb39..ea8bbd5e286887 100644 --- a/doc/api/util.md +++ b/doc/api/util.md @@ -1308,7 +1308,9 @@ The encoding supported by the `TextEncoder` instance. Always set to `'utf-8'`. ## `util.toUSVString(string)` * `string` {string} diff --git a/doc/api/v8.md b/doc/api/v8.md index f94231451a5982..d4972163cc6f80 100644 --- a/doc/api/v8.md +++ b/doc/api/v8.md @@ -228,6 +228,7 @@ setTimeout(() => { v8.setFlagsFromString('--notrace_gc'); }, 60e3); @@ -241,6 +242,7 @@ records and optimize code. This can be used in conjunction with diff --git a/doc/api/worker_threads.md b/doc/api/worker_threads.md index 33f2811a83c877..f9a1d91b4519c6 100644 --- a/doc/api/worker_threads.md +++ b/doc/api/worker_threads.md @@ -63,7 +63,9 @@ specifically `argv` and `execArgv` options. ## `worker.getEnvironmentData(key)` > Stability: 1 - Experimental @@ -280,7 +282,9 @@ new Worker('process.env.SET_IN_WORKER = "foo"', { eval: true, env: SHARE_ENV }) ## `worker.setEnvironmentData(key[, value])` > Stability: 1 - Experimental @@ -527,10 +531,14 @@ are part of the channel.