2018-10-10, Version 10.12.0 (Current)

targos · targos · commit 4a276cc2a960 · 2018-10-10T09:10:08.000-07:00
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
diff --git a/CHANGELOG.md b/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/>
diff --git a/doc/api/cli.md b/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.
diff --git a/doc/api/crypto.md b/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}
diff --git a/doc/api/errors.md b/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,
diff --git a/doc/api/fs.md b/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.
diff --git a/doc/api/http2.md b/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.
diff --git a/doc/api/modules.md b/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
diff --git a/doc/api/process.md b/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'`.
diff --git a/doc/api/util.md b/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.
 -->
diff --git a/doc/changelogs/CHANGELOG_V10.md b/doc/changelogs/CHANGELOG_V10.md
diff --git a/src/node_version.h b/src/node_version.h
