2018-10-10, Version 10.12.0 (Current)

Notable changes:

* assert
  * The diff output is now a tiny bit improved by sorting object
    properties when inspecting the values that are compared with each
    other. #22788
* cli
  * The options parser now normalizes `_` to `-` in all multi-word
    command-line flags, e.g. `--no_warnings` has the same effect as
    `--no-warnings`. #23020
  * Added bash completion for the `node` binary. To generate a bash
    completion script, run `node --completion-bash`. The output can be
    saved to a file which can be sourced to enable completion.
    #20713
* crypto
  * Added support for PEM-level encryption.
    #23151
  * Added an API asymmetric key pair generation. The new methods
    `crypto.generateKeyPair` and `crypto.generateKeyPairSync` can be
    used to generate public and private key pairs. The API supports
    RSA, DSA and EC and a variety of key encodings (both PEM and DER).
    #22660
* fs
  * Added a `recursive` option to `fs.mkdir` and `fs.mkdirSync`. If
    this option is set to true, non-existing parent folders will be
    automatically created. #21875
* http2
  * Added a `'ping'` event to `Http2Session` that is emitted whenever a
    non-ack `PING` is received.
    #23009
  * Added support for the `ORIGIN` frame.
    #22956
  * Updated nghttp2 to 1.34.0. This adds RFC 8441 extended connect
    protocol support to allow use of WebSockets over HTTP/2.
    #23284
* module
  * Added `module.createRequireFromPath(filename)`. This new method can
    be used to create a custom require function that will resolve
    modules relative to the filename path.
    #19360
* process
  * Added a `'multipleResolves'` process event that is emitted whenever
    a `Promise` is attempted to be resolved multiple times, e.g. if the
    `resolve` and `reject` functions are both called in a `Promise`
    executor. #22218
* url
  * Added `url.fileURLToPath(url)` and `url.pathToFileURL(path)`. These
    methods can be used to correctly convert between file: URLs and
    absolute paths. #22506
* util
  * Added the `sorted` option to `util.inspect()`. If set to `true`,
    all properties of an object and Set and Map entries will be sorted
    in the returned string. If set to a function, it is used as a
    compare function. #22788
  * The `util.instpect.custom` symbol is now defined in the global
    symbol registry as `Symbol.for('nodejs.util.inspect.custom')`.
    #20857
  * Added support for `BigInt` numbers in `util.format()`.
    #22097
* V8 API
  * A number of V8 C++ APIs have been marked as deprecated since they
    have been removed in the upstream repository. Replacement APIs
    are added where necessary. #23159
* Windows
  * The Windows msi installer now provides an option to automatically
    install the tools required to build native modules.
    #22645
* Workers
  * Debugging support for Workers using the DevTools protocol has been
    implemented. #21364
  * The public `inspector` module is now enabled in Workers.
    #22769
* Added new collaborators:
  * digitalinfinity - Hitesh Kanwathirtha

PR-URL: #23313

CHANGELOG.md

@@ -31,7 +31,8 @@ release.
 </tr>
 <tr>
     <td valign="top">
-<b><a href="doc/changelogs/CHANGELOG_V10.md#10.11.0">10.11.0</a></b><br/>
+<b><a href="doc/changelogs/CHANGELOG_V10.md#10.12.0">10.12.0</a></b><br/>
+<a href="doc/changelogs/CHANGELOG_V10.md#10.11.0">10.11.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V10.md#10.10.0">10.10.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V10.md#10.9.0">10.9.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V10.md#10.8.0">10.8.0</a><br/>

doc/api/cli.md

@@ -23,7 +23,7 @@ _For more info about `node inspect`, please see the [debugger][] documentation._
 ## Options
 <!-- YAML
 changes:
-  - version: REPLACEME
+  - version: v10.12.0
     pr-url: https://github.com/nodejs/node/pull/23020
     description: Underscores instead of dashes are now allowed for
                  Node.js options as well, in addition to V8 options.
@@ -66,7 +66,7 @@ If this flag is passed, the behavior can still be set to not abort through
 
 ### `--completion-bash`
 <!-- YAML
-added: REPLACEME
+added: v10.12.0
 -->
 
 Print source-able bash completion script for Node.js.

doc/api/crypto.md

@@ -1697,7 +1697,7 @@ signing algorithms. Optional `options` argument controls the
 
 ### crypto.generateKeyPair(type, options, callback)
 <!-- YAML
-added: REPLACEME
+added: v10.12.0
 -->
 * `type`: {string} Must be `'rsa'`, `'dsa'` or `'ec'`.
 * `options`: {Object}
@@ -1758,7 +1758,7 @@ a `Promise` for an `Object` with `publicKey` and `privateKey` properties.
 
 ### crypto.generateKeyPairSync(type, options)
 <!-- YAML
-added: REPLACEME
+added: v10.12.0
 -->
 * `type`: {string} Must be `'rsa'`, `'dsa'` or `'ec'`.
 * `options`: {Object}

doc/api/errors.md

@@ -1944,9 +1944,9 @@ The `repl` module was unable to parse data from the REPL history file.
 <a id="ERR_STDERR_CLOSE"></a>
 ### ERR_STDERR_CLOSE
 <!-- YAML
-removed: REPLACEME
+removed: v10.12.0
 changes:
-  - version: REPLACEME
+  - version: v10.12.0
     pr-url: https://github.com/nodejs/node/pull/23053
     description: Rather than emitting an error, `process.stderr.end()` now
                  only closes the stream side but not the underlying resource,
@@ -1959,9 +1959,9 @@ does not allow `stdout` or `stderr` streams to be closed by user code.
 <a id="ERR_STDOUT_CLOSE"></a>
 ### ERR_STDOUT_CLOSE
 <!-- YAML
-removed: REPLACEME
+removed: v10.12.0
 changes:
-  - version: REPLACEME
+  - version: v10.12.0
     pr-url: https://github.com/nodejs/node/pull/23053
     description: Rather than emitting an error, `process.stderr.end()` now
                  only closes the stream side but not the underlying resource,

doc/api/fs.md

@@ -2143,7 +2143,7 @@ Synchronous lstat(2).
 <!-- YAML
 added: v0.1.8
 changes:
-  - version: REPLACEME
+  - version: v10.12.0
     pr-url: https://github.com/nodejs/node/pull/21875
     description: The second argument can now be an `options` object with
                  `recursive` and `mode` properties.
@@ -2188,7 +2188,7 @@ See also: mkdir(2).
 <!-- YAML
 added: v0.1.21
 changes:
-  - version: REPLACEME
+  - version: v10.12.0
     pr-url: https://github.com/nodejs/node/pull/21875
     description: The second argument can now be an `options` object with
                  `recursive` and `mode` properties.

doc/api/http2.md

@@ -224,7 +224,7 @@ session.on('localSettings', (settings) => {
 
 #### Event: 'ping'
 <!-- YAML
-added: REPLACEME
+added: v10.12.0
 -->
 
 * `payload` {Buffer} The `PING` frame 8-byte payload
@@ -684,7 +684,7 @@ are passed through as provided by the user or received from the peer.
 
 #### serverhttp2session.origin(...origins)
 <!-- YAML
-added: REPLACEME
+added: v10.12.0
 -->
 
 * `origins` { string | URL | Object } One or more URL Strings passed as
@@ -764,7 +764,7 @@ client.on('altsvc', (alt, origin, streamId) => {
 
 #### Event: 'origin'
 <!-- YAML
-added: REPLACEME
+added: v10.12.0
 -->
 
 * `origins` {string[]}
@@ -2000,7 +2000,7 @@ server.listen(80);
 <!-- YAML
 added: v8.4.0
 changes:
-  - version: REPLACEME
+  - version: v10.12.0
     pr-url: https://github.com/nodejs/node/pull/22956
     description: Added the `origins` option to automatically send an `ORIGIN`
                  frame on `Http2Session` startup.

doc/api/modules.md

@@ -891,7 +891,7 @@ const builtin = require('module').builtinModules;
 
 ### module.createRequireFromPath(filename)
 <!-- YAML
-added: REPLACEME
+added: v10.12.0
 -->
 
 * `filename` {string} Filename to be used to construct the relative require

doc/api/process.md

@@ -99,7 +99,7 @@ not be the same as what is originally sent.
 
 ### Event: 'multipleResolves'
 <!-- YAML
-added: REPLACEME
+added: v10.12.0
 -->
 
 * `type` {string} The error type. One of `'resolve'` or `'reject'`.

doc/api/util.md

@@ -361,7 +361,7 @@ stream.write('With ES6');
 <!-- YAML
 added: v0.3.0
 changes:
-  - version: REPLACEME
+  - version: v10.12.0
     pr-url: https://github.com/nodejs/node/pull/22788
     description: The `sorted` option is supported now.
   - version: v10.6.0
@@ -663,7 +663,7 @@ util.inspect(obj);
 <!-- YAML
 added: v6.6.0
 changes:
-  - version: REPLACEME
+  - version: v10.12.0
     pr-url: https://github.com/nodejs/node/pull/20857
     description: This is now defined as a shared symbol.
 -->