升级到 v12.12.0

Gaojiahui · Oct 14, 2019 · 96ee7e8 · 96ee7e8
1 parent 18cfe49
commit 96ee7e8
Show file tree

Hide file tree

Showing 108 changed files with 643 additions and 299 deletions.
diff --git a/assert/assert_fail_actual_expected_message_operator_stackstartfn.md b/assert/assert_fail_actual_expected_message_operator_stackstartfn.md
@@ -7,22 +7,22 @@ changes:
                  deprecated and emits a warning.
 -->
 
+> Stability: 0 - Deprecated: Use `assert.fail([message])` or other assert
+> functions instead.
+
 * `actual` {any}
 * `expected` {any}
 * `message` {string|Error}
 * `operator` {string} **Default:** `'!='`
 * `stackStartFn` {Function} **Default:** `assert.fail`
 
-> Stability: 0 - Deprecated: Use `assert.fail([message])` or other assert
-> functions instead.
-
 If `message` is falsy, the error message is set as the values of `actual` and
 `expected` separated by the provided `operator`. If just the two `actual` and
 `expected` arguments are provided, `operator` will default to `'!='`. If
 `message` is provided as third argument it will be used as the error message and
 the other arguments will be stored as properties on the thrown object. If
 `stackStartFn` is provided, all stack frames above that function will be
-removed from stacktrace (see [`Error.captureStackTrace`]). If no arguments are
+removed from stacktrace (see [`Error.captureStackTrace`][]). If no arguments are
 given, the default message `Failed` will be used.
 
 ```js

diff --git a/buffer/buf_lastindexof_value_byteoffset_encoding.md b/buffer/buf_lastindexof_value_byteoffset_encoding.md
@@ -7,7 +7,7 @@ changes:
 -->
 
 * `value` {string|Buffer|Uint8Array|integer} 要查找的值。
-* `byteOffset` {integer} `buf` 中开始查找的偏移量。**默认值:** [`buf.length`]` - 1`。
+* `byteOffset` {integer} `buf` 中开始查找的偏移量。**默认值:** `buf.length - 1`。
 * `encoding` {string} 如果 `value` 是字符串，则指定 `value` 的字符编码。**默认值:** `'utf8'`。
 * 返回: {integer} `buf` 中最后一次出现 `value` 的索引，如果 `buf` 没包含 `value` 则返回 `-1`。
 

diff --git a/cli/enable_source_maps.md b/cli/enable_source_maps.md
@@ -0,0 +1,8 @@
+<!-- YAML
+added: v12.12.0
+-->
+
+> Stability: 1 - Experimental
+
+Enable experimental Source Map V3 support for stack traces.
+
diff --git a/cli/experimental_json_modules.md b/cli/experimental_json_modules.md
@@ -0,0 +1,6 @@
+<!-- YAML
+added: v12.9.0
+-->
+
+Enable experimental JSON support for the ES Module loader.
+
diff --git a/cli/force_context_aware.md b/cli/force_context_aware.md
@@ -0,0 +1,6 @@
+<!-- YAML
+added: v12.12.0
+-->
+
+Disable loading native addons that are not [context-aware][].
+
diff --git a/cli/node_options_options.md b/cli/node_options_options.md
@@ -36,15 +36,18 @@ node --require "./a.js" --require "./b.js"
 Node.js options that are allowed are:
 <!-- node-options-node start -->
 * `--enable-fips`
+* `--enable-source-maps`
 * `--es-module-specifier-resolution`
 * `--experimental-exports`
+* `--experimental-json-modules`
 * `--experimental-loader`
 * `--experimental-modules`
 * `--experimental-policy`
 * `--experimental-repl-await`
 * `--experimental-report`
 * `--experimental-vm-modules`
 * `--experimental-wasm-modules`
+* `--force-context-aware`
 * `--force-fips`
 * `--frozen-intrinsics`
 * `--heapsnapshot-signal`

diff --git a/cli/uv_threadpool_size_size.md b/cli/uv_threadpool_size_size.md
@@ -38,5 +38,6 @@ greater than `4` (its current default value). For more information, see the
 
 
 
+
 
 
diff --git a/crypto/crypto_creatediffiehellmangroup_name.md b/crypto/crypto_creatediffiehellmangroup_name.md
@@ -3,7 +3,7 @@ added: v0.9.3
 -->
 
 * `name` {string}
-* Returns: {DiffieHellman}
+* Returns: {DiffieHellmanGroup}
 
 An alias for [`crypto.getDiffieHellman()`][]
 
diff --git a/crypto/crypto_generatekeypair_type_options_callback.md b/crypto/crypto_generatekeypair_type_options_callback.md
@@ -32,7 +32,7 @@ and Ed448 are currently supported.
 
 If a `publicKeyEncoding` or `privateKeyEncoding` was specified, this function
 behaves as if [`keyObject.export()`][] had been called on its result. Otherwise,
-the respective part of the key is returned as a [`KeyObject`].
+the respective part of the key is returned as a [`KeyObject`][].
 
 It is recommended to encode public keys as `'spki'` and private keys as
 `'pkcs8'` with encryption for long-term storage:

diff --git a/crypto/crypto_generatekeypairsync_type_options.md b/crypto/crypto_generatekeypairsync_type_options.md
@@ -27,7 +27,7 @@ and Ed448 are currently supported.
 
 If a `publicKeyEncoding` or `privateKeyEncoding` was specified, this function
 behaves as if [`keyObject.export()`][] had been called on its result. Otherwise,
-the respective part of the key is returned as a [`KeyObject`].
+the respective part of the key is returned as a [`KeyObject`][].
 
 When encoding public keys, it is recommended to use `'spki'`. When encoding
 private keys, it is recommended to use `'pks8'` with a strong passphrase, and to

diff --git a/crypto/crypto_getdiffiehellman_groupname.md b/crypto/crypto_getdiffiehellman_groupname.md
@@ -3,9 +3,9 @@ added: v0.7.5
 -->
 
 * `groupName` {string}
-* Returns: {DiffieHellman}
+* Returns: {DiffieHellmanGroup}
 
-Creates a predefined `DiffieHellman` key exchange object. The
+Creates a predefined `DiffieHellmanGroup` key exchange object. The
 supported groups are: `'modp1'`, `'modp2'`, `'modp5'` (defined in
 [RFC 2412][], but see [Caveats][]) and `'modp14'`, `'modp15'`,
 `'modp16'`, `'modp17'`, `'modp18'` (defined in [RFC 3526][]). The

diff --git a/deprecations/dep0005_buffer_constructor.md b/deprecations/dep0005_buffer_constructor.md
@@ -32,8 +32,9 @@ objects:
 * [`Buffer.from(string[, encoding])`][from_string_encoding] - Create a `Buffer`
   that copies `string`.
 
-As of v10.0.0, a deprecation warning is printed at runtime when
-`--pending-deprecation` is used or when the calling code is
-outside `node_modules` in order to better target developers, rather than users.
+Without `--pending-deprecation`, runtime warnings occur only for code not in
+`node_modules`. This means there will not be deprecation warnings for
+`Buffer()` usage in dependencies. With `--pending-deprecation`, a runtime
+warning results no matter where the `Buffer()` usage occurs.
 
 <a id="DEP0006"></a>
diff --git a/deprecations/dep0132_worker_terminate_with_callback.md b/deprecations/dep0132_worker_terminate_with_callback.md
@@ -10,107 +10,4 @@ Type: Runtime
 Passing a callback to [`worker.terminate()`][] is deprecated. Use the returned
 `Promise` instead, or a listener to the worker’s `'exit'` event.
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+<a id="DEP0133"></a>
diff --git a/deprecations/dep0133_http_connection.md b/deprecations/dep0133_http_connection.md
@@ -0,0 +1,13 @@
+<!-- YAML
+changes:
+  - version: v12.12.0
+    pr-url: https://github.com/nodejs/node/pull/29015
+    description: Documentation-only deprecation.
+-->
+
+Type: Documentation-only
+
+Prefer [`response.socket`][] over [`response.connection`][] and
+[`request.socket`][] over [`request.connection`][].
+
+<a id="DEP0134"></a>
diff --git a/deprecations/dep0134_process_tickcallback.md b/deprecations/dep0134_process_tickcallback.md
@@ -0,0 +1,115 @@
+<!-- YAML
+changes:
+  - version: v12.12.0
+    pr-url: https://github.com/nodejs/node/pull/29781
+    description: Documentation-only deprecation.
+-->
+Type: Documentation-only (supports [`--pending-deprecation`][])
+
+The `process._tickCallback` property was never documented as
+an officially supported API.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/dgram/dgram_createsocket_type_callback.md b/dgram/dgram_createsocket_type_callback.md
@@ -7,8 +7,6 @@ added: v0.1.99
 * 返回: {dgram.Socket}
 
 创建一个特定 `type` 的 `dgram.Socket` 对象。
-`type` 参数是 `'udp4'` 或 `'udp6'`。
-可选传一个 `callback` 函数，作为 `'message'` 事件的监听器。
 
 一旦套接字被创建，调用 [`socket.bind()`] 会指示套接字开始监听数据报消息。
 如果 `address` 和 `port` 没传给  [`socket.bind()`]，那么这个方法会把这个套接字绑定到 "全部接口" 地址的一个随机端口（这适用于 `udp4` 和 `udp6` 套接字）。
Original file line number	Diff line number	Diff line change
Expand Up		@@ -38,5 +38,6 @@ greater than `4` (its current default value). For more information, see the
Original file line number	Diff line number	Diff line change
Expand Up		@@ -10,107 +10,4 @@ Type: Runtime
		Passing a callback to [`worker.terminate()`][] is deprecated. Use the returned
		`Promise` instead, or a listener to the worker’s `'exit'` event.









































































































		<a id="DEP0133"></a>