From d896f03578f2312aaae347de3b5a0b26882effc8 Mon Sep 17 00:00:00 2001 From: Beth Griggs Date: Fri, 22 Mar 2019 13:19:46 +0000 Subject: 2019-04-23, Version 12.0.0 (Current) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Notable changes: * assert: * validate required arguments (Ruben Bridgewater) [#26641](https://github.com/nodejs/node/pull/26641) * adjust loose assertions (Ruben Bridgewater) [#25008](https://github.com/nodejs/node/pull/25008) * async_hooks: * remove deprecated `emitBefore` and `emitAfter` (Matteo Collina) [#26530](https://github.com/nodejs/node/pull/26530) * remove promise object from resource (Andreas Madsen) [#23443](https://github.com/nodejs/node/pull/23443) * bootstrap: make Buffer and process non-enumerable (Ruben Bridgewater) [#24874](https://github.com/nodejs/node/pull/24874) * buffer: * use stricter range checks (Ruben Bridgewater) [#27045](https://github.com/nodejs/node/pull/27045) * harden `SlowBuffer` creation (ZYSzys) [#26272](https://github.com/nodejs/node/pull/26272) * harden validation of buffer allocation size (ZYSzys) [#26162](https://github.com/nodejs/node/pull/26162) * do proper error propagation in addon methods (Anna Henningsen) [#23939](https://github.com/nodejs/node/pull/23939) * child_process: * remove `options.customFds` (cjihrig) [#25279](https://github.com/nodejs/node/pull/25279) * harden fork arguments validation (ZYSzys) [#27039](https://github.com/nodejs/node/pull/27039) * use non-infinite `maxBuffer` defaults (kohta ito) [#23027](https://github.com/nodejs/node/pull/23027) * console: * don't use ANSI escape codes when `TERM=dumb` (Vladislav Kaminsky) [#26261](https://github.com/nodejs/node/pull/26261) * crypto: * remove legacy native handles (Tobias Nießen) [#27011](https://github.com/nodejs/node/pull/27011) * decode missing passphrase errors (Tobias Nießen) [#25208](https://github.com/nodejs/node/pull/25208) * remove `Cipher.setAuthTag()` and `Decipher.getAuthTag()` (Tobias Nießen) [#26249](https://github.com/nodejs/node/pull/26249) * remove deprecated `crypto._toBuf()` (Tobias Nießen) [#25338](https://github.com/nodejs/node/pull/25338) * set `DEFAULT\_ENCODING` property to non-enumerable (Antoine du Hamel) [#23222](https://github.com/nodejs/node/pull/23222) * deps: * update V8 to 7.4.288.13 (Michaël Zasso, cjihrig, Refael Ackermann) (Anna Henningsen, Ujjwal Sharma) [#26685](https://github.com/nodejs/node/pull/26685) * bump minimum icu version to 63 (Ujjwal Sharma) [#25852](https://github.com/nodejs/node/pull/25852) * update OpenSSL to 1.1.1b (Sam Roberts, Shigeki Ohtsu) [#26327](https://github.com/nodejs/node/pull/26327) * errors: * update error name (Ruben Bridgewater) [#26738](https://github.com/nodejs/node/pull/26738) * fs: * use proper .destroy() implementation for SyncWriteStream (Matteo Collina) [#26690](https://github.com/nodejs/node/pull/26690) * improve mode validation (Ruben Bridgewater) [#26575](https://github.com/nodejs/node/pull/26575) * harden validation of start option in `createWriteStream()` (ZYSzys) [#25579](https://github.com/nodejs/node/pull/25579) * make writeFile consistent with readFile wrt fd (Sakthipriyan Vairamani (thefourtheye)) [#23709](https://github.com/nodejs/node/pull/23709) * http: * validate timeout in `ClientRequest()` (cjihrig) [#26214](https://github.com/nodejs/node/pull/26214) * return HTTP 431 on `HPE_HEADER_OVERFLOW` error (Albert Still) [#25605](https://github.com/nodejs/node/pull/25605) * switch default parser to llhttp (Anna Henningsen) [#24870](https://github.com/nodejs/node/pull/24870) * Runtime-deprecate `outgoingMessage._headers` and `outgoingMessage._headerNames` (Morgan Roderick) [#24167](https://github.com/nodejs/node/pull/24167) * lib: * remove `Atomics.wake()` (Gus Caplan) [#27033](https://github.com/nodejs/node/pull/27033) * move DTRACE\_\* probes out of global scope (James M Snell) [#26541](https://github.com/nodejs/node/pull/26541) * deprecate `_stream_wrap` (Sam Roberts) [#26245](https://github.com/nodejs/node/pull/26245) * use ES6 class inheritance style (Ruben Bridgewater) [#24755](https://github.com/nodejs/node/pull/24755) * module: * remove unintended access to deps/ (Anna Henningsen) [#25138](https://github.com/nodejs/node/pull/25138) * improve error message for MODULE\_NOT\_FOUND (Ali Ijaz Sheikh) [#25690](https://github.com/nodejs/node/pull/25690) * requireStack property for MODULE\_NOT\_FOUND (Ali Ijaz Sheikh) [#25690](https://github.com/nodejs/node/pull/25690) * remove dead code (Ruben Bridgewater) [#26983](https://github.com/nodejs/node/pull/26983) * make `require('.')` never resolve outside the current directory (Ruben Bridgewater) [#26973](https://github.com/nodejs/node/pull/26973) * throw an error for invalid package.json main entries (Ruben Bridgewater) [#26823](https://github.com/nodejs/node/pull/26823) * don't search in `require.resolve.paths` (cjihrig) [#23683](https://github.com/nodejs/node/pull/23683) * net: * remove `Server.listenFD()` (cjihrig) [#27127](https://github.com/nodejs/node/pull/27127) * do not add `.host` and `.port` properties to DNS error (Ruben Bridgewater) [#26751](https://github.com/nodejs/node/pull/26751) * emit "write after end" errors in the next tick (Ouyang Yadong) [#24457](https://github.com/nodejs/node/pull/24457) * deprecate `_setSimultaneousAccepts()` undocumented function (James M Snell) [#23760](https://github.com/nodejs/node/pull/23760) * os: * implement `os.type()` using `uv_os_uname()` (cjihrig) [#25659](https://github.com/nodejs/node/pull/25659) * remove `os.getNetworkInterfaces()` (cjihrig) [#25280](https://github.com/nodejs/node/pull/25280) * process: * make global.process, global.Buffer getters (Guy Bedford) [#26882](https://github.com/nodejs/node/pull/26882) * move DEP0062 (node --debug) to end-of-life (Joyee Cheung) [#25828](https://github.com/nodejs/node/pull/25828) * exit on --debug and --debug-brk after option parsing (Joyee Cheung) [#25828](https://github.com/nodejs/node/pull/25828) * improve `--redirect-warnings` handling (Ruben Bridgewater) [#24965](https://github.com/nodejs/node/pull/24965) * readline: * support TERM=dumb (Vladislav Kaminsky) [#26261](https://github.com/nodejs/node/pull/26261) * repl: * add welcome message (gengjiawen) [#25947](https://github.com/nodejs/node/pull/25947) * fix terminal default setting (Ruben Bridgewater) [#26518](https://github.com/nodejs/node/pull/26518) * check colors with `.getColorDepth()` (Vladislav Kaminsky) [#26261](https://github.com/nodejs/node/pull/26261) * deprecate REPLServer.rli (Ruben Bridgewater) [#26260](https://github.com/nodejs/node/pull/26260) * src: * remove unused `INT_MAX` constant (Sam Roberts) [#27078](https://github.com/nodejs/node/pull/27078) * update `NODE_MODULE_VERSION` to 72 (Ujjwal Sharma) [#26685](https://github.com/nodejs/node/pull/26685) * remove `AddPromiseHook()` (Anna Henningsen) [#26574](https://github.com/nodejs/node/pull/26574) * clean up `MultiIsolatePlatform` interface (Anna Henningsen) [#26384](https://github.com/nodejs/node/pull/26384) * properly configure default heap limits (Ali Ijaz Sheikh) [#25576](https://github.com/nodejs/node/pull/25576) * remove `icuDataDir` from node config (GauthamBanasandra) [#24780](https://github.com/nodejs/node/pull/24780) * tls: * support TLSv1.3 (Sam Roberts) [#26209](https://github.com/nodejs/node/pull/26209) * return correct version from `getCipher()` (Sam Roberts) [#26625](https://github.com/nodejs/node/pull/26625) * check arg types of renegotiate() (Sam Roberts) [#25876](https://github.com/nodejs/node/pull/25876) * add code for `ERR_TLS_INVALID_PROTOCOL_METHOD` (Sam Roberts) [#24729](https://github.com/nodejs/node/pull/24729) * emit a warning when servername is an IP address (Rodger Combs) [#23329](https://github.com/nodejs/node/pull/23329) * disable TLS v1.0 and v1.1 by default (Ben Noordhuis) [#23814](https://github.com/nodejs/node/pull/23814) * remove unused arg to createSecureContext() (Sam Roberts) [#24241](https://github.com/nodejs/node/pull/24241) * deprecate `Server.prototype.setOptions()` (cjihrig) [#23820](https://github.com/nodejs/node/pull/23820) * load `NODE_EXTRA_CA_CERTS` at startup (Ouyang Yadong) [#23354](https://github.com/nodejs/node/pull/23354) * util: * remove `util.print()`, `util.puts()`, `util.debug()` and `util.error()` (cjihrig) [#25377](https://github.com/nodejs/node/pull/25377) * change inspect compact and breakLength default (Ruben Bridgewater) [#27109](https://github.com/nodejs/node/pull/27109) * improve inspect edge cases (Ruben Bridgewater) [#27109](https://github.com/nodejs/node/pull/27109) * only the first line of the error message (Simon Zünd) [#26685](https://github.com/nodejs/node/pull/26685) * don't set the prototype of callbackified functions (Ruben Bridgewater) [#26893](https://github.com/nodejs/node/pull/26893) * rename callbackified function (Ruben Bridgewater) [#26893](https://github.com/nodejs/node/pull/26893) * increase function length when using `callbackify()` (Ruben Bridgewater) [#26893](https://github.com/nodejs/node/pull/26893) * prevent tampering with internals in `inspect()` (Ruben Bridgewater) [#26577](https://github.com/nodejs/node/pull/26577) * prevent Proxy traps being triggered by `.inspect()` (Ruben Bridgewater) [#26241](https://github.com/nodejs/node/pull/26241) * prevent leaking internal properties (Ruben Bridgewater) [#24971](https://github.com/nodejs/node/pull/24971) * protect against monkeypatched Object prototype for inspect() (Rich Trott) [#25953](https://github.com/nodejs/node/pull/25953) * treat format arguments equally (Roman Reiss) [#23162](https://github.com/nodejs/node/pull/23162) * win, fs: * detect if symlink target is a directory (Bartosz Sosnowski) [#23724](https://github.com/nodejs/node/pull/23724) * zlib: * throw TypeError if callback is missing (Anna Henningsen) [#24929](https://github.com/nodejs/node/pull/24929) * make “bare” constants un-enumerable (Anna Henningsen) [#24824](https://github.com/nodejs/node/pull/24824) PR-URL: https://github.com/nodejs/node/pull/26930 --- doc/api/assert.md | 2 +- doc/api/buffer.md | 8 ++++---- doc/api/cli.md | 38 +++++++++++++++++++------------------- doc/api/crypto.md | 22 +++++++++++----------- doc/api/deprecations.md | 44 ++++++++++++++++++++++---------------------- doc/api/dgram.md | 10 +++++----- doc/api/errors.md | 2 +- doc/api/fs.md | 4 ++-- doc/api/http.md | 2 +- doc/api/process.md | 2 +- doc/api/repl.md | 4 ++-- doc/api/tls.md | 4 ++-- doc/api/util.md | 8 ++++---- 13 files changed, 75 insertions(+), 75 deletions(-) (limited to 'doc/api') diff --git a/doc/api/assert.md b/doc/api/assert.md index 67bc9afbab..9028d21f0d 100644 --- a/doc/api/assert.md +++ b/doc/api/assert.md @@ -163,7 +163,7 @@ An alias of [`assert.ok()`][]. * `offset` {integer} Number of bytes to skip before starting to read. Must @@ -1565,7 +1565,7 @@ 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 @@ -2192,7 +2192,7 @@ console.log(`${len} bytes: ${buf.toString('utf8', 0, len)}`); ### buf.writeBigInt64BE(value[, offset]) ### buf.writeBigInt64LE(value[, offset]) * `value` {bigint} Number to be written to `buf`. @@ -2218,7 +2218,7 @@ console.log(buf); ### buf.writeBigUInt64BE(value[, offset]) ### buf.writeBigUInt64LE(value[, offset]) * `value` {bigint} Number to be written to `buf`. diff --git a/doc/api/cli.md b/doc/api/cli.md index fed5aa90aa..c0682d864c 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -77,7 +77,7 @@ $ source node_bash_completion ### `--cpu-prof` > Stability: 1 - Experimental @@ -99,7 +99,7 @@ CPU.20190409.202950.15293.0.0.cpuprofile ### `--cpu-prof-dir` > Stability: 1 - Experimental @@ -109,7 +109,7 @@ be placed. ### `--cpu-prof-name` > Stability: 1 - Experimental @@ -126,7 +126,7 @@ Enable FIPS-compliant crypto at startup. (Requires Node.js to be built with ### `--es-module-specifier-resolution=mode` To be used in conjunction with `--experimental-modules`. Sets the resolution @@ -140,7 +140,7 @@ Please see [customizing esm specifier resolution][] for example usage. ### `--experimental-json-modules` Enable experimental JSON support for the ES Module loader. @@ -209,7 +209,7 @@ Both of the above may change in future updates, which will be breaking changes. ### `--heapsnapshot-signal=signal` Generates a heap snapshot each time the process receives the specified signal. @@ -240,7 +240,7 @@ Specify ICU data load path. (Overrides `NODE_ICU_DATA`.) ### `--input-type=type` Used with `--experimental-modules`, this configures Node.js to interpret string @@ -455,7 +455,7 @@ warning will be written to stderr instead. Set [`tls.DEFAULT_MAX_VERSION`][] to 'TLSv1.2'. Use to disable support for @@ -564,7 +564,7 @@ TLSv1.3. ### `--tls-max-v1.3` Set default [`tls.DEFAULT_MAX_VERSION`][] to 'TLSv1.3'. Use to enable support @@ -572,7 +572,7 @@ for TLSv1.3. ### `--tls-min-v1.0` Set default [`tls.DEFAULT_MIN_VERSION`][] to 'TLSv1'. Use for compatibility with @@ -580,7 +580,7 @@ old TLS clients or servers. ### `--tls-min-v1.1` Set default [`tls.DEFAULT_MIN_VERSION`][] to 'TLSv1.1'. Use for compatibility @@ -588,7 +588,7 @@ with old TLS clients or servers. ### `--tls-min-v1.3` Set default [`tls.DEFAULT_MIN_VERSION`][] to 'TLSv1.3'. Use to disable support @@ -648,7 +648,7 @@ Track heap object allocations for heap snapshots. ### `--unhandled-rejections=mode` By default all unhandled rejections trigger a warning plus a deprecation warning diff --git a/doc/api/crypto.md b/doc/api/crypto.md index 9ba401f153..e6392d2d51 100644 --- a/doc/api/crypto.md +++ b/doc/api/crypto.md @@ -1129,17 +1129,17 @@ passing keys as strings or `Buffer`s due to improved security features. @@ -1284,7 +1284,7 @@ console.log(verify.verify(publicKey, signature)); * `algorithm` {string | null | undefined} * `data` {Buffer | TypedArray | DataView} @@ -2742,7 +2742,7 @@ not introduce timing vulnerabilities. ### crypto.verify(algorithm, data, key, signature) * `algorithm` {string | null | undefined} * `data` {Buffer | TypedArray | DataView} diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md index cf06f69fc8..f2c737bddd 100644 --- a/doc/api/deprecations.md +++ b/doc/api/deprecations.md @@ -160,7 +160,7 @@ outside `node_modules` in order to better target developers, rather than users. ### DEP0006: child\_process options.customFds @@ -1367,7 +1367,7 @@ removed. Please use `sloppy` instead. ### DEP0066: outgoingMessage.\_headers, outgoingMessage.\_headerNames @@ -2327,7 +2327,7 @@ https://github.com/nodejs/node/issues/18391 ### DEP0122: tls Server.prototype.setOptions() @@ -2340,7 +2340,7 @@ Please use `Server.prototype.setSecureContext()` instead. ### DEP0123: setting the TLS ServerName to an IP address @@ -2354,7 +2354,7 @@ Setting the TLS ServerName to an IP address is not permitted by ### DEP0124: using REPLServer.rli @@ -2367,7 +2367,7 @@ This property is a reference to the instance itself. ### DEP0125: require('\_stream\_wrap') @@ -2412,7 +2412,7 @@ with no performance impact since Node.js 10. ### DEP0128: modules with an invalid `main` entry and an `index.js` file diff --git a/doc/api/dgram.md b/doc/api/dgram.md index 7ef483bc23..1d815ba56b 100644 --- a/doc/api/dgram.md +++ b/doc/api/dgram.md @@ -51,7 +51,7 @@ Once triggered, no new `'message'` events will be emitted on this socket. ### Event: 'connect' The `'connect'` event is emitted after a socket is associated to a remote @@ -247,7 +247,7 @@ provided, it is added as a listener for the [`'close'`][] event. ### socket.connect(port[, address][, callback]) * `port` {integer} @@ -266,7 +266,7 @@ the `callback` is called or, failing this, an `'error'` event is emitted. ### socket.disconnect() A synchronous function that disassociates a connected `dgram.Socket` from @@ -321,7 +321,7 @@ chained. ### socket.remoteAddress() * Returns: {Object} @@ -348,7 +348,7 @@ changes: pr-url: https://github.com/nodejs/node/pull/4374 description: The `msg` parameter can be an array now. Also, the `offset` and `length` parameters are optional now. - - version: REPLACEME + - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/26871 description: Added support for sending data on connected sockets. --> diff --git a/doc/api/errors.md b/doc/api/errors.md index 097b0208f7..a21b4ac852 100644 --- a/doc/api/errors.md +++ b/doc/api/errors.md @@ -1989,7 +1989,7 @@ an `Error` with this code will be emitted. ### MODULE_NOT_FOUND diff --git a/doc/api/fs.md b/doc/api/fs.md index c96b2cf5c5..0ce63f98ce 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -3043,7 +3043,7 @@ changes: description: The `target` and `path` parameters can be WHATWG `URL` objects using `file:` protocol. Support is currently still *experimental*. - - version: REPLACEME + - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/23724 description: If the `type` argument is left undefined, Node will autodetect `target` type and automatically select `dir` or `file` @@ -3081,7 +3081,7 @@ changes: description: The `target` and `path` parameters can be WHATWG `URL` objects using `file:` protocol. Support is currently still *experimental*. - - version: REPLACEME + - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/23724 description: If the `type` argument is left undefined, Node will autodetect `target` type and automatically select `dir` or `file` diff --git a/doc/api/http.md b/doc/api/http.md index 927e64554e..ccd5e4b0bd 100644 --- a/doc/api/http.md +++ b/doc/api/http.md @@ -838,7 +838,7 @@ changes: description: The `rawPacket` is the current buffer that just parsed. Adding this buffer to the error object of `'clientError'` event is to make it possible that developers can log the broken packet. - - version: REPLACEME + - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/25605 description: The default behavior will return a 431 Request Header Fields Too Large if a HPE_HEADER_OVERFLOW error occurs. diff --git a/doc/api/process.md b/doc/api/process.md index 95f57f6932..c868f01fa1 100644 --- a/doc/api/process.md +++ b/doc/api/process.md @@ -206,7 +206,7 @@ most convenient for scripts). diff --git a/doc/api/repl.md b/doc/api/repl.md index cc7f3f96da..b4ee0b7bdb 100644 --- a/doc/api/repl.md +++ b/doc/api/repl.md @@ -479,8 +479,8 @@ with REPL instances programmatically.