diff --git a/doc/api/assert.md b/doc/api/assert.md index d5d0a606c2bf46..9731ddaa13f315 100644 --- a/doc/api/assert.md +++ b/doc/api/assert.md @@ -11,7 +11,9 @@ invariants. * `string` {string} @@ -780,7 +784,9 @@ let err; ## `assert.match(string, regexp[, message])` * `string` {string} diff --git a/doc/api/buffer.md b/doc/api/buffer.md index b839f0cebad093..52e86430ede831 100644 --- a/doc/api/buffer.md +++ b/doc/api/buffer.md @@ -1341,7 +1341,9 @@ The `buf.parent` property is a deprecated alias for `buf.buffer`. ### `buf.readBigInt64BE([offset])` ### `buf.readBigInt64LE([offset])` * `offset` {integer} Number of bytes to skip before starting to read. Must @@ -1357,7 +1359,9 @@ Integers read from a `Buffer` are interpreted as two's complement signed values. ### `buf.readBigUInt64BE([offset])` ### `buf.readBigUInt64LE([offset])` * `offset` {integer} Number of bytes to skip before starting to read. Must @@ -2027,7 +2031,9 @@ console.log(`${length} bytes: ${buffer.toString('utf8', 8, 10)}`); ### `buf.writeBigInt64BE(value[, offset])` ### `buf.writeBigInt64LE(value[, offset])` * `value` {bigint} Number to be written to `buf`. @@ -2053,7 +2059,9 @@ console.log(buf); ### `buf.writeBigUInt64BE(value[, offset])` ### `buf.writeBigUInt64LE(value[, offset])` * `value` {bigint} Number to be written to `buf`. diff --git a/doc/api/child_process.md b/doc/api/child_process.md index 4c1bd5891b7012..5657f2014ab7e4 100644 --- a/doc/api/child_process.md +++ b/doc/api/child_process.md @@ -329,7 +329,9 @@ arbitrary command execution.** Child processes support a serialization mechanism for IPC that is based on the diff --git a/doc/api/cli.md b/doc/api/cli.md index 0e66b9e574a53a..7b7fbc83524522 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -167,7 +167,9 @@ Currently, overriding `Error.prepareStackTrace` is ignored when the ### `--experimental-import-meta-resolve` Enable experimental `import.meta.resolve()` support. @@ -210,7 +212,9 @@ Enable experimental top-level `await` keyword support in REPL. ### `--experimental-specifier-resolution=mode` Sets the resolution algorithm for resolving ES module specifiers. Valid options @@ -231,7 +235,9 @@ Enable experimental ES Module support in the `vm` module. ### `--experimental-wasi-unstable-preview1` Use an insecure HTTP parser that accepts invalid HTTP headers. This may allow @@ -439,7 +448,9 @@ disappear in a non-semver-major release. ### `--max-http-header-size=size` Log TLS key material to a file. The key material is in NSS `SSLKEYLOGFILE` @@ -746,7 +759,9 @@ traffic. ### `--tls-max-v1.2` Set [`tls.DEFAULT_MAX_VERSION`][] to 'TLSv1.2'. Use to disable support for @@ -762,7 +777,9 @@ for TLSv1.3. ### `--tls-min-v1.0` Set default [`tls.DEFAULT_MIN_VERSION`][] to 'TLSv1'. Use for compatibility with @@ -770,7 +787,9 @@ old TLS clients or servers. ### `--tls-min-v1.1` Set default [`tls.DEFAULT_MIN_VERSION`][] to 'TLSv1.1'. Use for compatibility @@ -778,7 +797,9 @@ with old TLS clients or servers. ### `--tls-min-v1.2` Set default [`tls.DEFAULT_MIN_VERSION`][] to 'TLSv1.2'. This is the default for @@ -825,7 +846,9 @@ Enables the collection of trace event tracing information. ### `--trace-exit` Prints a stack trace whenever an environment is exited proactively, @@ -882,7 +905,9 @@ Track heap object allocations for heap snapshots. ### `--unhandled-rejections=mode` By default all unhandled rejections trigger a warning plus a deprecation warning @@ -1273,7 +1298,9 @@ to an empty string (`''` or `' '`) disables persistent REPL history. ### `NODE_REPL_EXTERNAL_MODULE=file` Path to a Node.js module which will be loaded in place of the built-in REPL. diff --git a/doc/api/cluster.md b/doc/api/cluster.md index a1eb0859c87d8f..c12c9758b94c9f 100644 --- a/doc/api/cluster.md +++ b/doc/api/cluster.md @@ -724,7 +724,9 @@ values are `'rr'` and `'none'`. diff --git a/doc/api/dgram.md b/doc/api/dgram.md index 57a38e3895f018..71c363e4a116cb 100644 --- a/doc/api/dgram.md +++ b/doc/api/dgram.md @@ -128,7 +128,9 @@ if (cluster.isMaster) { ### `socket.addSourceSpecificMembership(sourceAddress, groupAddress[, multicastInterface])` * `sourceAddress` {string} * `groupAddress` {string} @@ -317,7 +319,9 @@ drop membership on all valid interfaces. ### `socket.dropSourceSpecificMembership(sourceAddress, groupAddress[, multicastInterface])` * `sourceAddress` {string} diff --git a/doc/api/errors.md b/doc/api/errors.md index 480bbdfbd23e42..5b1599febea9b7 100644 --- a/doc/api/errors.md +++ b/doc/api/errors.md @@ -2145,7 +2145,9 @@ Creation of a [`zlib`][] object failed due to incorrect configuration. ### `HPE_HEADER_OVERFLOW` diff --git a/doc/api/events.md b/doc/api/events.md index b23da5a523ea40..a30e2abb01353c 100644 --- a/doc/api/events.md +++ b/doc/api/events.md @@ -224,7 +224,9 @@ recommendation is to **not use `async` functions as `'error'` event handlers**. @@ -362,7 +364,9 @@ Its `name` property is set to `'MaxListenersExceededWarning'`. ### `EventEmitter.errorMonitor` This symbol shall be used to install a listener for only monitoring `'error'` @@ -783,7 +787,9 @@ emitter.emit('log'); ### `emitter[Symbol.for('nodejs.rejection')](err, eventName[, ...args])` > Stability: 1 - captureRejections is experimental. @@ -819,7 +825,9 @@ class MyClass extends EventEmitter { ## `events.once(emitter, name)` * `emitter` {EventEmitter} @@ -865,7 +873,9 @@ run(); ## `events.captureRejections` > Stability: 1 - captureRejections is experimental. @@ -876,7 +886,9 @@ Change the default `captureRejections` option on all new `EventEmitter` objects. ## `events.captureRejectionSymbol` > Stability: 1 - captureRejections is experimental. @@ -887,7 +899,9 @@ See how to write a custom [rejection handler][rejection]. ## `events.on(emitter, eventName)` * `emitter` {EventEmitter} diff --git a/doc/api/fs.md b/doc/api/fs.md index a899686cae16a1..4291e120eeadf4 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -637,7 +637,9 @@ argument to `fs.createReadStream()`. If `path` is passed as a string, then ### `readStream.pending` * {boolean} @@ -2653,7 +2655,9 @@ Functions based on `fs.open()` exhibit this behavior as well: @@ -2680,7 +2684,9 @@ directory and subsequent read operations. @@ -3332,7 +3338,9 @@ Synchronous rename(2). Returns `undefined`. @@ -5200,7 +5212,9 @@ upon success. > Stability: 0 - Deprecated. Use [`request.writableEnded`][]. @@ -729,9 +731,10 @@ request.removeHeader('Content-Type'); ``` ### `request.reusedSocket` - * {boolean} Whether the request is send through a reused socket. @@ -1133,7 +1136,9 @@ Stops the server from accepting new connections. See [`net.Server.close()`][]. ### `server.headersTimeout` * {number} **Default:** `60000` @@ -1305,7 +1310,9 @@ See [`response.socket`][]. ### `response.cork()` See [`writable.cork()`][]. @@ -1337,7 +1344,9 @@ is finished. ### `response.finished` > Stability: 0 - Deprecated. Use [`response.writableEnded`][]. @@ -1604,7 +1613,9 @@ status message which was sent out. ### `response.uncork()` See [`writable.uncork()`][]. @@ -1680,7 +1691,9 @@ the request body should be sent. See the [`'checkContinue'`][] event on @@ -2058,7 +2073,10 @@ Found'`. * {number} @@ -2189,7 +2209,10 @@ This can be overridden for servers and client requests by passing the * {number} @@ -1988,10 +1990,14 @@ value only affects new connections to the server, not any existing connections. > Stability: 0 - Deprecated. Use [`response.writableEnded`][]. @@ -3429,7 +3441,9 @@ should be sent. See the [`'checkContinue'`][] event on `Http2Server` and * `line` {Buffer} Line of ASCII text, in NSS `SSLKEYLOGFILE` format. diff --git a/doc/api/n-api.md b/doc/api/n-api.md index de588519849dde..91f3aeb870613c 100644 --- a/doc/api/n-api.md +++ b/doc/api/n-api.md @@ -374,7 +374,9 @@ tied to the life cycle of the Agent. ### napi_set_instance_data @@ -402,7 +404,9 @@ by the previous call, it will not be called. ### napi_get_instance_data @@ -1665,7 +1669,9 @@ the `napi_value` in question is of the JavaScript type expected by the API. ### Enum types #### napi_key_collection_mode @@ -1686,7 +1692,9 @@ of the objects's prototype chain as well. #### napi_key_filter @@ -1705,7 +1713,9 @@ Property filter bits. They can be or'ed to build a composite filter. #### napi_key_conversion @@ -1902,7 +1912,9 @@ structure, in most cases using a `TypedArray` will suffice. #### napi_create_date @@ -2583,7 +2595,9 @@ This API returns various properties of a `DataView`. #### napi_get_date_value @@ -3201,7 +3215,9 @@ This API checks if the `Object` passed in is a buffer. ### napi_is_date @@ -3297,7 +3313,9 @@ defined in [Section 7.2.14][] of the ECMAScript Language Specification. ### napi_detach_arraybuffer > Stability: 1 - Experimental @@ -3323,7 +3341,9 @@ defined in [Section 24.1.1.3][] of the ECMAScript Language Specification. ### napi_is_detached_arraybuffer > Stability: 1 - Experimental @@ -3592,7 +3612,9 @@ included. #### napi_get_all_property_names @@ -5181,7 +5203,9 @@ prevent the event loop from exiting. The APIs `napi_ref_threadsafe_function` and added: v10.6.0 napiVersion: 4 changes: - - version: v12.6.0 + - version: + - v12.6.0 + - v10.17.0 pr-url: https://github.com/nodejs/node/pull/27791 description: Made `func` parameter optional with custom `call_js_cb`. --> diff --git a/doc/api/net.md b/doc/api/net.md index aa2b918ecdac12..28842d0abe9b90 100644 --- a/doc/api/net.md +++ b/doc/api/net.md @@ -787,7 +787,9 @@ Useful to throttle back an upload. ### `socket.pending` * {boolean} diff --git a/doc/api/process.md b/doc/api/process.md index 79972f2778c706..2851f9a29b731d 100644 --- a/doc/api/process.md +++ b/doc/api/process.md @@ -224,7 +224,9 @@ most convenient for scripts). diff --git a/doc/api/readline.md b/doc/api/readline.md index f36f0db9db73b1..272481a9f155c3 100644 --- a/doc/api/readline.md +++ b/doc/api/readline.md @@ -315,9 +315,13 @@ The `rl.write()` method will write the data to the `readline` `Interface`'s ### `rl[Symbol.asyncIterator]()` @@ -401,7 +405,9 @@ as well as the column where the terminal caret will be rendered. ### `rl.getCursorPos()` * Returns: {Object} diff --git a/doc/api/report.md b/doc/api/report.md index 6fa8d92a9bf4b4..7807063fdc5725 100644 --- a/doc/api/report.md +++ b/doc/api/report.md @@ -580,7 +580,9 @@ Specific API documentation can be found under ## Interaction with Workers diff --git a/doc/api/stream.md b/doc/api/stream.md index 0f89b77bc35782..e8993849090199 100644 --- a/doc/api/stream.md +++ b/doc/api/stream.md @@ -519,7 +519,9 @@ does not indicate whether the data has been flushed, for this use ##### `writable.writableCorked` * {integer} @@ -1809,17 +1811,19 @@ method. #### Constructor: `new stream.Writable([options])` * `options` {Object} @@ -2093,7 +2097,9 @@ constructor and implement the `readable._read()` method. #### `new stream.Readable([options])` * `line` {Buffer} Line of ASCII text, in NSS `SSLKEYLOGFILE` format. @@ -692,7 +694,9 @@ Construct a new `tls.TLSSocket` object from an existing TCP socket. ### Event: `'keylog'` * `line` {Buffer} Line of ASCII text, in NSS `SSLKEYLOGFILE` format. @@ -857,13 +861,15 @@ socket has been destroyed, `null` will be returned. * Returns: {Object} @@ -1277,7 +1283,9 @@ changes: - version: REPLACEME pr-url: https://github.com/nodejs/node/pull/32786 description: The `highWaterMark` option is accepted now. - - version: v13.6.0 + - version: + - v13.6.0 + - v12.16.0 pr-url: https://github.com/nodejs/node/pull/23188 description: The `pskCallback` option is now supported. - version: v12.9.0 @@ -1289,7 +1297,9 @@ changes: - version: v12.2.0 pr-url: https://github.com/nodejs/node/pull/27497 description: The `enableTrace` option is now supported. - - version: v11.8.0 + - version: + - v11.8.0 + - v10.16.0 pr-url: https://github.com/nodejs/node/pull/25517 description: The `timeout` option is supported now. - version: v8.0.0 @@ -1475,7 +1485,9 @@ changes: - version: v11.5.0 pr-url: https://github.com/nodejs/node/pull/24733 description: The `ca:` option now supports `BEGIN TRUSTED CERTIFICATE`. - - version: v11.4.0 + - version: + - v11.4.0 + - v10.16.0 pr-url: https://github.com/nodejs/node/pull/24405 description: The `minVersion` and `maxVersion` can be used to restrict the allowed TLS protocol versions. diff --git a/doc/api/tty.md b/doc/api/tty.md index 0c2f963750fd1f..e4d753f7c12cad 100644 --- a/doc/api/tty.md +++ b/doc/api/tty.md @@ -216,7 +216,9 @@ of columns and rows in the corresponding [TTY](tty.html). ### `writeStream.hasColors([count][, env])` * `count` {integer} The number of colors that are requested (minimum 2). diff --git a/doc/api/util.md b/doc/api/util.md index 616542f6daf1ce..757c6a48f6ece9 100644 --- a/doc/api/util.md +++ b/doc/api/util.md @@ -401,7 +401,9 @@ changes: - version: v14.0.0 pr-url: https://github.com/nodejs/node/pull/32392 description: The `maxStringLength` option is supported now. - - version: v13.5.0 + - version: + - v13.5.0 + - v12.16.0 pr-url: https://github.com/nodejs/node/pull/30768 description: User defined prototype properties are inspected in case `showHidden` is `true`. @@ -1002,7 +1004,9 @@ throw an error. diff --git a/doc/api/vm.md b/doc/api/vm.md index e959ebc66ff24e..dc210b1c42b16d 100644 --- a/doc/api/vm.md +++ b/doc/api/vm.md @@ -347,7 +347,9 @@ vm.measureMemory({ mode: 'detailed' }, context) ## Class: `vm.Module` > Stability: 1 - Experimental @@ -696,7 +698,9 @@ const module2 = new vm.SourceTextModule('const a = 1;', { cachedData }); ## Class: `vm.SyntheticModule` > Stability: 1 - Experimental @@ -725,7 +729,9 @@ const module = new vm.SyntheticModule(['default'], function() { ### Constructor: `new vm.SyntheticModule(exportNames, evaluateCallback[, options])` * `exportNames` {string[]} Array of names that will be exported from the module. @@ -745,7 +751,9 @@ the module to access information outside the specified `context`. Use ### `syntheticModule.setExport(name, value)` * `name` {string} Name of the export to set. diff --git a/doc/api/wasi.md b/doc/api/wasi.md index 27dceaa014f7e8..1fe78aeecd6a1f 100644 --- a/doc/api/wasi.md +++ b/doc/api/wasi.md @@ -1,6 +1,6 @@ # WebAssembly System Interface (WASI) - + > Stability: 1 - Experimental @@ -34,7 +34,9 @@ CLI arguments are needed for the previous example to run. ## Class: `WASI` The `WASI` class provides the WASI system call API and additional convenience @@ -45,7 +47,9 @@ sandbox directory structure configured explicitly. ### `new WASI([options])` * `options` {Object} @@ -65,7 +69,9 @@ added: v13.3.0 ### `wasi.start(instance)` * `instance` {WebAssembly.Instance} @@ -80,7 +86,9 @@ is present on `instance`, then `start()` does nothing. ### `wasi.wasiImport` * {Object} diff --git a/doc/api/worker_threads.md b/doc/api/worker_threads.md index dd324ba8068b7b..2d6c3c23940cf2 100644 --- a/doc/api/worker_threads.md +++ b/doc/api/worker_threads.md @@ -165,7 +165,9 @@ When this function is used, no `'message'` event will be emitted and the ## `worker.resourceLimits` * {Object} @@ -520,10 +522,14 @@ changes: pr-url: https://github.com/nodejs/node/pull/31664 description: The `filename` parameter can be a WHATWG `URL` object using `file:` protocol. - - version: v13.2.0 + - version: + - v13.2.0 + - v12.16.0 pr-url: https://github.com/nodejs/node/pull/26628 description: The `resourceLimits` option was introduced. - - version: v13.4.0 + - version: + - v13.4.0 + - v12.16.0 pr-url: https://github.com/nodejs/node/pull/30559 description: The `argv` option was introduced. --> @@ -664,7 +670,9 @@ no effect. ### `worker.resourceLimits` * {Object} diff --git a/doc/api/zlib.md b/doc/api/zlib.md index 195c874f8decbc..079efeb6a10cf9 100644 --- a/doc/api/zlib.md +++ b/doc/api/zlib.md @@ -411,7 +411,9 @@ Compression strategy. ### Brotli constants There are several options and other constants available for Brotli-based @@ -545,14 +547,18 @@ const stream = zlib.createBrotliCompress({ ## Class: `zlib.BrotliCompress` Compress data using the Brotli algorithm. ## Class: `zlib.BrotliDecompress` Decompress data using the Brotli algorithm. @@ -633,7 +639,9 @@ the header. @@ -727,7 +735,9 @@ Provides an object enumerating Zlib-related constants. ## `zlib.createBrotliCompress([options])` * `options` {brotli options} @@ -736,7 +746,9 @@ Creates and returns a new [`BrotliCompress`][] object. ## `zlib.createBrotliDecompress([options])` * `options` {brotli options} @@ -828,7 +840,9 @@ without a callback. ### `zlib.brotliCompress(buffer[, options], callback)` * `buffer` {Buffer|TypedArray|DataView|ArrayBuffer|string} @@ -837,7 +851,9 @@ added: v11.7.0 ### `zlib.brotliCompressSync(buffer[, options])` * `buffer` {Buffer|TypedArray|DataView|ArrayBuffer|string} @@ -847,7 +863,9 @@ Compress a chunk of data with [`BrotliCompress`][]. ### `zlib.brotliDecompress(buffer[, options], callback)` * `buffer` {Buffer|TypedArray|DataView|ArrayBuffer|string} @@ -856,7 +874,9 @@ added: v11.7.0 ### `zlib.brotliDecompressSync(buffer[, options])` * `buffer` {Buffer|TypedArray|DataView|ArrayBuffer|string}