From 7af8896d99f5e61704c887c993ec2e8446f390ad 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 | 8 +- doc/api/buffer.md | 16 +- doc/api/child_process.md | 24 +- doc/api/cli.md | 8 +- doc/api/deprecations.md | 2 +- doc/api/dns.md | 6 +- doc/api/errors.md | 4 +- doc/api/esm.md | 4 +- doc/api/fs.md | 12 +- doc/api/http.md | 2 +- doc/api/http2.md | 4 +- doc/api/https.md | 2 +- doc/api/modules.md | 2 +- doc/api/n-api.md | 2 +- doc/api/net.md | 24 +- doc/api/os.md | 2 +- doc/api/perf_hooks.md | 8 +- doc/api/process.md | 6 +- doc/api/readline.md | 8 +- doc/api/stream.md | 2 +- doc/api/tls.md | 2 +- doc/api/url.md | 2 +- doc/api/util.md | 2 +- doc/api/v8.md | 4 +- doc/api/worker_threads.md | 8 +- doc/changelogs/CHANGELOG_V14.md | 492 ++++++++++++++++++++++++++++++++ src/node_version.h | 6 +- 28 files changed, 579 insertions(+), 86 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index eaeb829e8e7d6d..fd40fceec02a5e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -30,7 +30,8 @@ release. -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 13942c021fad19..82af718884a109 100644 --- a/doc/api/assert.md +++ b/doc/api/assert.md @@ -304,7 +304,7 @@ An alias of [`assert.ok()`][]. > Stability: 1 - Experimental @@ -299,7 +299,7 @@ multiple worker threads. ### `new buffer.Blob([sources[, options]])` * `sources` {string[]|ArrayBuffer[]|TypedArray[]|DataView[]|Blob[]} An array @@ -321,7 +321,7 @@ String sources are also copied into the `Blob`. ### `blob.arrayBuffer()` * Returns: {Promise} @@ -331,14 +331,14 @@ the `Blob` data. ### `blob.size` The total size of the `Blob` in bytes. ### `blob.slice([start, [end, [type]]])` * `start` {number} The starting index. @@ -350,7 +350,7 @@ data. The original `Blob` is not alterered. ### `blob.text()` * Returns: {Promise} @@ -360,7 +360,7 @@ string. ### `blob.type` * Type: {string} diff --git a/doc/api/child_process.md b/doc/api/child_process.md index c209dff8b0d2c8..13e8b1b6f7fae2 100644 --- a/doc/api/child_process.md +++ b/doc/api/child_process.md @@ -146,7 +146,7 @@ exec('"my script.cmd" a b', (err, stdout, stderr) => { Set the default value of `verbatim` in [`dns.lookup()`][] and @@ -208,7 +208,7 @@ Enable FIPS-compliant crypto at startup. (Requires Node.js to be built with @@ -352,7 +352,7 @@ be added. ### `--heapsnapshot-near-heap-limit=max_count` > Stability: 1 - Experimental @@ -611,7 +611,7 @@ 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 458f1a7832a13e..484d565cc72d9d 100644 --- a/doc/api/deprecations.md +++ b/doc/api/deprecations.md @@ -2656,7 +2656,7 @@ Use `fs.rm(path, { recursive: true, force: true })` instead. ### DEP0151: Main index lookup and extension searching * `order` {string} must be `'ipv4first'` or `'verbatim'`. @@ -1153,7 +1153,7 @@ is one of the [DNS error codes](#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 8a5d3e5daf21f2..7abf3a8fe0fe6d 100644 --- a/doc/api/errors.md +++ b/doc/api/errors.md @@ -879,7 +879,7 @@ An unknown Diffie-Hellman group name was given. See ### `ERR_DLOPEN_FAILED` A call to `process.dlopen()` failed. @@ -1432,7 +1432,7 @@ 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 3c0a400b5c4746..632569537b62e7 100644 --- a/doc/api/esm.md +++ b/doc/api/esm.md @@ -203,7 +203,7 @@ added: - v14.13.1 - v12.20.0 changes: - - version: REPLACEME + - version: v14.18.0 pr-url: https://github.com/nodejs/node/pull/37246 description: Added `node:` import support to `require(...)`. --> @@ -282,7 +282,7 @@ added: - v13.9.0 - v12.16.2 changes: - - version: REPLACEME + - version: 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 182ff873f106df..88cbbb4afbc170 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -494,7 +494,7 @@ the end of the file. @@ -1203,7 +1203,7 @@ The `atime` and `mtime` arguments follow these rules: ### `fsPromises.watch(filename[, options])` * `filename` {string|Buffer|URL} @@ -1254,7 +1254,7 @@ All the [caveats][] for `fs.watch()` also apply to `fsPromises.watch()`. diff --git a/doc/api/http.md b/doc/api/http.md index c4d5173ce0791b..5f6d3804eedcf5 100644 --- a/doc/api/http.md +++ b/doc/api/http.md @@ -2767,7 +2767,7 @@ This can be overridden for servers and client requests by passing the * `windowSize` {number} @@ -2597,7 +2597,7 @@ the given `Buffer` as generated by `http2.getPackedSettings()`. ### `http2.sensitiveHeaders` * {symbol} diff --git a/doc/api/https.md b/doc/api/https.md index 1c0b601cfbeb19..785a066cc25710 100644 --- a/doc/api/https.md +++ b/doc/api/https.md @@ -251,7 +251,7 @@ 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 7d50bfcf5b62ef..2dc473dca16513 100644 --- a/doc/api/n-api.md +++ b/doc/api/n-api.md @@ -5965,7 +5965,7 @@ This API may only be called from the main thread. ## node_api_get_module_file_name > Stability: 1 - Experimental diff --git a/doc/api/net.md b/doc/api/net.md index 2a8ade43dd3e09..abf57a570c30cb 100644 --- a/doc/api/net.md +++ b/doc/api/net.md @@ -57,7 +57,7 @@ net.createServer().listen( ## Class: `net.BlockList` The `BlockList` object can be used with some network APIs to specify rules for @@ -66,7 +66,7 @@ IP subnets. ### `blockList.addAddress(address[, type])` * `address` {string|net.SocketAddress} An IPv4 or IPv6 address. @@ -76,7 +76,7 @@ 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 @@ -89,7 +89,7 @@ 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. @@ -102,7 +102,7 @@ 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 @@ -129,7 +129,7 @@ console.log(blockList.check('::ffff:123.123.123.123', 'ipv6')); // Prints: true ### `blockList.rules` * Type: {string[]} @@ -138,11 +138,11 @@ The list of rules added to the blocklist. ## Class: `net.SocketAddress` ### `new net.SocketAddress([options])` * `options` {Object} @@ -155,28 +155,28 @@ added: REPLACEME ### `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 0f6e1d5dd23d83..f9812d4a8490b4 100644 --- a/doc/api/os.md +++ b/doc/api/os.md @@ -124,7 +124,7 @@ are always 0. ## `os.devNull` * {string} diff --git a/doc/api/perf_hooks.md b/doc/api/perf_hooks.md index 6883712c435664..df946236f17123 100644 --- a/doc/api/perf_hooks.md +++ b/doc/api/perf_hooks.md @@ -653,7 +653,7 @@ performance.mark('meow'); ## `perf_hooks.createHistogram([options])` * `options` {Object} @@ -812,19 +812,19 @@ 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 f0f72fc07a7587..601fc892532c07 100644 --- a/doc/api/process.md +++ b/doc/api/process.md @@ -457,7 +457,7 @@ The `*-deprecation` command-line flags only affect warnings that use the name ### Event: `'worker'` * `worker` {Worker} The {Worker} that was created. @@ -1618,7 +1618,7 @@ program memory allocations. ## `process.memoryUsage.rss()` * Returns: {integer} @@ -2350,7 +2350,7 @@ 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 7412cc6eee1d0e..e78310fcfc97e7 100644 --- a/doc/api/readline.md +++ b/doc/api/readline.md @@ -90,7 +90,7 @@ rl.on('line', (input) => { ### Event: `'history'` The `'history'` event is emitted whenever the history array has changed. @@ -436,7 +436,7 @@ asynchronous iteration may result in missed lines. @@ -544,10 +544,10 @@ the current position of the cursor down. * {boolean} diff --git a/doc/api/tls.md b/doc/api/tls.md index 548766604502dd..b40273a83a5292 100644 --- a/doc/api/tls.md +++ b/doc/api/tls.md @@ -1357,7 +1357,7 @@ 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 91d5d0f678038e..63e4789e0628f2 100644 --- a/doc/api/util.md +++ b/doc/api/util.md @@ -1310,7 +1310,7 @@ 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 d6286ab37d3553..f8037e56156253 100644 --- a/doc/api/v8.md +++ b/doc/api/v8.md @@ -226,7 +226,7 @@ setTimeout(() => { v8.setFlagsFromString('--notrace_gc'); }, 60e3); ## `v8.stopCoverage()` The `v8.stopCoverage()` method allows the user to stop the coverage collection @@ -237,7 +237,7 @@ records and optimize code. This can be used in conjunction with ## `v8.takeCoverage()` The `v8.takeCoverage()` method allows the user to write the coverage started by diff --git a/doc/api/worker_threads.md b/doc/api/worker_threads.md index 34971d1d32829d..77e72535697b02 100644 --- a/doc/api/worker_threads.md +++ b/doc/api/worker_threads.md @@ -63,7 +63,7 @@ specifically `argv` and `execArgv` options. ## `worker.getEnvironmentData(key)` > Stability: 1 - Experimental @@ -274,7 +274,7 @@ new Worker('process.env.SET_IN_WORKER = "foo"', { eval: true, env: SHARE_ENV }) ## `worker.setEnvironmentData(key[, value])` > Stability: 1 - Experimental @@ -427,10 +427,10 @@ are part of the channel.