2016-12-04 21:47:01 +01:00
|
|
|
|
# Deprecated APIs
|
|
|
|
|
|
2017-11-04 09:08:46 +01:00
|
|
|
|
<!--introduced_in=v7.7.0-->
|
2018-04-14 04:05:56 +02:00
|
|
|
|
<!-- type=misc -->
|
2017-11-04 09:08:46 +01:00
|
|
|
|
|
2019-05-30 00:57:26 +02:00
|
|
|
|
Node.js may deprecate APIs for any of the following reasons:
|
|
|
|
|
|
2019-06-06 13:15:36 +02:00
|
|
|
|
* Use of the API is unsafe.
|
2019-05-30 00:57:26 +02:00
|
|
|
|
* An improved alternative API is available.
|
|
|
|
|
* Breaking changes to the API are expected in a future major release.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Node.js utilizes three kinds of Deprecations:
|
|
|
|
|
|
|
|
|
|
* Documentation-only
|
|
|
|
|
* Runtime
|
|
|
|
|
* End-of-Life
|
|
|
|
|
|
|
|
|
|
A Documentation-only deprecation is one that is expressed only within the
|
|
|
|
|
Node.js API docs. These generate no side-effects while running Node.js.
|
2018-01-29 18:23:09 +01:00
|
|
|
|
Some Documentation-only deprecations trigger a runtime warning when launched
|
|
|
|
|
with [`--pending-deprecation`][] flag (or its alternative,
|
|
|
|
|
`NODE_PENDING_DEPRECATION=1` environment variable), similarly to Runtime
|
|
|
|
|
deprecations below. Documentation-only deprecations that support that flag
|
|
|
|
|
are explicitly labeled as such in the
|
|
|
|
|
[list of Deprecated APIs](#deprecations_list_of_deprecated_apis).
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
A Runtime deprecation will, by default, generate a process warning that will
|
|
|
|
|
be printed to `stderr` the first time the deprecated API is used. When the
|
2019-07-10 18:26:50 +02:00
|
|
|
|
[`--throw-deprecation`][] command-line flag is used, a Runtime deprecation will
|
2016-12-04 21:47:01 +01:00
|
|
|
|
cause an error to be thrown.
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
An End-of-Life deprecation is used when functionality is or will soon be removed
|
|
|
|
|
from Node.js.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-05-04 19:22:09 +02:00
|
|
|
|
## Revoking deprecations
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-05-04 19:22:09 +02:00
|
|
|
|
Occasionally, the deprecation of an API may be reversed. In such situations,
|
2016-12-04 21:47:01 +01:00
|
|
|
|
this document will be updated with information relevant to the decision.
|
2018-05-04 19:22:09 +02:00
|
|
|
|
However, the deprecation identifier will not be modified.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
## List of Deprecated APIs
|
|
|
|
|
|
|
|
|
|
<a id="DEP0001"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0001: `http.OutgoingMessage.prototype.flush`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2020-03-10 18:16:08 +01:00
|
|
|
|
- version: v14.0.0
|
2020-01-02 22:13:19 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/31164
|
|
|
|
|
description: End-of-Life.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v1.6.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/1156
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2020-01-02 22:13:19 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2020-01-02 22:13:19 +01:00
|
|
|
|
`OutgoingMessage.prototype.flush()` has been removed. Use
|
2016-12-04 21:47:01 +01:00
|
|
|
|
`OutgoingMessage.prototype.flushHeaders()` instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0002"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0002: `require('_linklist')`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/12113
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v5.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/3078
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2017-12-22 01:30:07 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
The `_linklist` module is deprecated. Please use a userland alternative.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0003"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0003: `_writableState.buffer`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2020-03-10 18:16:08 +01:00
|
|
|
|
- version: v14.0.0
|
2020-01-02 22:26:50 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/31165
|
|
|
|
|
description: End-of-Life
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.11.15
|
|
|
|
|
pr-url: https://github.com/nodejs/node-v0.x-archive/pull/8826
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2020-01-02 22:26:50 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2020-01-02 22:26:50 +01:00
|
|
|
|
The `_writableState.buffer` has been removed. Use `_writableState.getBuffer()`
|
|
|
|
|
instead.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0004"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0004: `CryptoStream.prototype.readyState`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/17882
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: 0.4.0
|
|
|
|
|
commit: 9c7f89bf56abd37a796fea621ad2e47dd33d2b82
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-07-30 19:17:51 +02:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-07-30 19:17:51 +02:00
|
|
|
|
The `CryptoStream.prototype.readyState` property was removed.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0005"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0005: `Buffer()` constructor
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/19524
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version: v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v6.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/4682
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-03-22 00:30:21 +01:00
|
|
|
|
Type: Runtime (supports [`--pending-deprecation`][])
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
The `Buffer()` function and `new Buffer()` constructor are deprecated due to
|
2019-06-02 17:32:04 +02:00
|
|
|
|
API usability issues that can lead to accidental security issues.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-06-02 17:32:04 +02:00
|
|
|
|
As an alternative, use one of the following methods of constructing `Buffer`
|
|
|
|
|
objects:
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-10-24 06:28:42 +02:00
|
|
|
|
* [`Buffer.alloc(size[, fill[, encoding]])`][alloc]: Create a `Buffer` with
|
2016-12-04 21:47:01 +01:00
|
|
|
|
*initialized* memory.
|
2019-10-24 06:28:42 +02:00
|
|
|
|
* [`Buffer.allocUnsafe(size)`][alloc_unsafe_size]: Create a `Buffer` with
|
2018-02-12 08:31:55 +01:00
|
|
|
|
*uninitialized* memory.
|
2019-10-24 06:28:42 +02:00
|
|
|
|
* [`Buffer.allocUnsafeSlow(size)`][]: Create a `Buffer` with *uninitialized*
|
2016-12-04 21:47:01 +01:00
|
|
|
|
memory.
|
2019-10-24 06:28:42 +02:00
|
|
|
|
* [`Buffer.from(array)`][]: Create a `Buffer` with a copy of `array`
|
2018-02-12 08:31:55 +01:00
|
|
|
|
* [`Buffer.from(arrayBuffer[, byteOffset[, length]])`][from_arraybuffer] -
|
|
|
|
|
Create a `Buffer` that wraps the given `arrayBuffer`.
|
2019-10-24 06:28:42 +02:00
|
|
|
|
* [`Buffer.from(buffer)`][]: Create a `Buffer` that copies `buffer`.
|
|
|
|
|
* [`Buffer.from(string[, encoding])`][from_string_encoding]: Create a `Buffer`
|
2018-02-12 08:31:55 +01:00
|
|
|
|
that copies `string`.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-09-30 04:30:44 +02:00
|
|
|
|
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.
|
2018-03-22 00:30:21 +01:00
|
|
|
|
|
2016-12-04 21:47:01 +01:00
|
|
|
|
<a id="DEP0006"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0006: `child_process` `options.customFds`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2018-12-30 01:53:03 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/25279
|
|
|
|
|
description: End-of-Life.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.11.14
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version: v0.5.11
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-12-30 01:53:03 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Within the [`child_process`][] module's `spawn()`, `fork()`, and `exec()`
|
|
|
|
|
methods, the `options.customFds` option is deprecated. The `options.stdio`
|
|
|
|
|
option should be used instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0007"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0007: Replace `cluster` `worker.suicide` with `worker.exitedAfterDisconnect`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/13702
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v7.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/3747
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version: v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v6.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/3743
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2017-06-15 17:22:07 +02:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2017-06-15 17:22:07 +02:00
|
|
|
|
In an earlier version of the Node.js `cluster`, a boolean property with the name
|
|
|
|
|
`suicide` was added to the `Worker` object. The intent of this property was to
|
|
|
|
|
provide an indication of how and why the `Worker` instance exited. In Node.js
|
|
|
|
|
6.0.0, the old property was deprecated and replaced with a new
|
2017-06-28 20:55:48 +02:00
|
|
|
|
[`worker.exitedAfterDisconnect`][] property. The old property name did not
|
2017-06-15 17:22:07 +02:00
|
|
|
|
precisely describe the actual semantics and was unnecessarily emotion-laden.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0008"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0008: `require('constants')`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v6.3.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/6534
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The `constants` module is deprecated. When requiring access to constants
|
2016-12-04 21:47:01 +01:00
|
|
|
|
relevant to specific Node.js builtin modules, developers should instead refer
|
|
|
|
|
to the `constants` property exposed by the relevant module. For instance,
|
|
|
|
|
`require('fs').constants` and `require('os').constants`.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0009"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0009: `crypto.pbkdf2` without digest
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2020-03-10 18:16:08 +01:00
|
|
|
|
- version: v14.0.0
|
2020-01-02 22:42:50 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/31166
|
|
|
|
|
description: End-of-Life (for `digest === null`)
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-14 13:02:44 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/22861
|
|
|
|
|
description: Runtime deprecation (for `digest === null`).
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/11305
|
2018-09-14 13:02:44 +02:00
|
|
|
|
description: End-of-Life (for `digest === undefined`).
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version: v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v6.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/4047
|
2018-09-14 13:02:44 +02:00
|
|
|
|
description: Runtime deprecation (for `digest === undefined`).
|
2018-09-08 11:44:11 +02:00
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2020-01-02 22:42:50 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2017-02-10 23:48:39 +01:00
|
|
|
|
Use of the [`crypto.pbkdf2()`][] API without specifying a digest was deprecated
|
2017-11-10 05:42:58 +01:00
|
|
|
|
in Node.js 6.0 because the method defaulted to using the non-recommended
|
2017-02-10 23:48:39 +01:00
|
|
|
|
`'SHA1'` digest. Previously, a deprecation warning was printed. Starting in
|
2018-09-14 13:02:44 +02:00
|
|
|
|
Node.js 8.0.0, calling `crypto.pbkdf2()` or `crypto.pbkdf2Sync()` with
|
|
|
|
|
`digest` set to `undefined` will throw a `TypeError`.
|
|
|
|
|
|
2018-10-03 01:01:19 +02:00
|
|
|
|
Beginning in Node.js v11.0.0, calling these functions with `digest` set to
|
2020-01-02 22:42:50 +01:00
|
|
|
|
`null` would print a deprecation warning to align with the behavior when `digest`
|
2018-09-14 13:02:44 +02:00
|
|
|
|
is `undefined`.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2020-01-02 22:42:50 +01:00
|
|
|
|
Now, however, passing either `undefined` or `null` will throw a `TypeError`.
|
|
|
|
|
|
2016-12-04 21:47:01 +01:00
|
|
|
|
<a id="DEP0010"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0010: `crypto.createCredentials`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-08 11:44:11 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/21153
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.11.13
|
|
|
|
|
pr-url: https://github.com/nodejs/node-v0.x-archive/pull/7265
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-06-25 23:31:43 +02:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-06-25 23:31:43 +02:00
|
|
|
|
The `crypto.createCredentials()` API was removed. Please use
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`tls.createSecureContext()`][] instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0011"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0011: `crypto.Credentials`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-08 11:44:11 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/21153
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.11.13
|
|
|
|
|
pr-url: https://github.com/nodejs/node-v0.x-archive/pull/7265
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-06-25 23:31:43 +02:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-06-25 23:31:43 +02:00
|
|
|
|
The `crypto.Credentials` class was removed. Please use [`tls.SecureContext`][]
|
2016-12-04 21:47:01 +01:00
|
|
|
|
instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0012"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0012: `Domain.dispose`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/15412
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.11.7
|
|
|
|
|
pr-url: https://github.com/nodejs/node-v0.x-archive/pull/5021
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2017-09-14 17:58:53 +02:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-05-04 18:55:05 +02:00
|
|
|
|
`Domain.dispose()` has been removed. Recover from failed I/O actions
|
2016-12-04 21:47:01 +01:00
|
|
|
|
explicitly via error event handlers set on the domain instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0013"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0013: `fs` asynchronous function without callback
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18668
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v7.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/7897
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-02-09 00:54:31 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-02-09 00:54:31 +01:00
|
|
|
|
Calling an asynchronous function without a callback throws a `TypeError`
|
2019-07-10 00:57:17 +02:00
|
|
|
|
in Node.js 10.0.0 onwards. See <https://github.com/nodejs/node/pull/12562>.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0014"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0014: `fs.read` legacy String interface
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/9683
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v6.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/4525
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.1.96
|
|
|
|
|
commit: c93e0aaf062081db3ec40ac45b3e2c979d5759d6
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: End-of-Life
|
|
|
|
|
|
2018-04-29 19:46:41 +02:00
|
|
|
|
The [`fs.read()`][] legacy `String` interface is deprecated. Use the `Buffer`
|
|
|
|
|
API as mentioned in the documentation instead.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0015"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0015: `fs.readSync` legacy String interface
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/9683
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v6.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/4525
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.1.96
|
|
|
|
|
commit: c93e0aaf062081db3ec40ac45b3e2c979d5759d6
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: End-of-Life
|
|
|
|
|
|
2018-04-29 19:46:41 +02:00
|
|
|
|
The [`fs.readSync()`][] legacy `String` interface is deprecated. Use the
|
|
|
|
|
`Buffer` API as mentioned in the documentation instead.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0016"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0016: `GLOBAL`/`root`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2020-03-10 18:16:08 +01:00
|
|
|
|
- version: v14.0.0
|
2020-02-07 16:18:07 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/31167
|
2020-01-02 23:01:10 +01:00
|
|
|
|
description: End-of-Life
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version: v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v6.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/1838
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2020-01-02 23:01:10 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2020-01-02 23:01:10 +01:00
|
|
|
|
The `GLOBAL` and `root` aliases for the `global` property were deprecated
|
|
|
|
|
in Node.js 6.0.0 and have since been removed.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0017"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0017: `Intl.v8BreakIterator`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/15238
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v7.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/8908
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2017-09-07 13:26:47 +02:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2017-09-07 13:26:47 +02:00
|
|
|
|
`Intl.v8BreakIterator` was a non-standard extension and has been removed.
|
|
|
|
|
See [`Intl.Segmenter`](https://github.com/tc39/proposal-intl-segmenter).
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0018"></a>
|
|
|
|
|
### DEP0018: Unhandled promise rejections
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v7.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/8217
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
Unhandled promise rejections are deprecated. In the future, promise rejections
|
|
|
|
|
that are not handled will terminate the Node.js process with a non-zero exit
|
|
|
|
|
code.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0019"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0019: `require('.')` resolved outside directory
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-03-29 03:11:41 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/26973
|
|
|
|
|
description: Removed functionality.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v1.8.1
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/1363
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-03-29 03:11:41 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-03-29 03:11:41 +01:00
|
|
|
|
In certain cases, `require('.')` could resolve outside the package directory.
|
|
|
|
|
This behavior has been removed.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0020"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0020: `Server.connections`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.9.7
|
|
|
|
|
pr-url: https://github.com/nodejs/node-v0.x-archive/pull/4595
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
The [`Server.connections`][] property is deprecated. Please use the
|
|
|
|
|
[`Server.getConnections()`][] method instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0021"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0021: `Server.listenFD`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-04-08 04:22:35 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/27127
|
|
|
|
|
description: End-of-Life.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.7.12
|
|
|
|
|
commit: 41421ff9da1288aa241a5e9dcf915b685ade1c23
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-04-08 04:22:35 +02:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-04-08 04:22:35 +02:00
|
|
|
|
The `Server.listenFD()` method was deprecated and removed. Please use
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`Server.listen({fd: <number>})`][] instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0022"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0022: `os.tmpDir()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2020-03-10 18:16:08 +01:00
|
|
|
|
- version: v14.0.0
|
2020-02-07 16:20:06 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/31169
|
2020-01-02 23:45:24 +01:00
|
|
|
|
description: End-of-Life.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version: v7.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/6739
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2020-01-02 23:45:24 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2020-02-07 16:21:55 +01:00
|
|
|
|
The `os.tmpDir()` API was deprecated in Node.js 7.0.0 and has since been
|
2020-01-02 23:45:24 +01:00
|
|
|
|
removed. Please use [`os.tmpdir()`][] instead.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0023"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0023: `os.getNetworkInterfaces()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2018-12-30 02:30:48 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/25280
|
|
|
|
|
description: End-of-Life.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.6.0
|
|
|
|
|
commit: 37bb37d151fb6ee4696730e63ff28bb7a4924f97
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-12-30 02:30:48 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
The `os.getNetworkInterfaces()` method is deprecated. Please use the
|
2018-12-30 02:30:48 +01:00
|
|
|
|
[`os.networkInterfaces()`][] method instead.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0024"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0024: `REPLServer.prototype.convertToContext()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/13434
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v7.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/7829
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2017-06-03 13:11:13 +02:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-09-07 22:21:56 +02:00
|
|
|
|
The `REPLServer.prototype.convertToContext()` API has been removed.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0025"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0025: `require('sys')`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v1.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/317
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
The `sys` module is deprecated. Please use the [`util`][] module instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0026"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0026: `util.print()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-01-10 18:51:08 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/25377
|
2019-01-07 18:42:17 +01:00
|
|
|
|
description: End-of-Life.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.11.3
|
|
|
|
|
commit: 896b2aa7074fc886efd7dd0a397d694763cac7ce
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-01-07 18:42:17 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-01-07 18:42:17 +01:00
|
|
|
|
`util.print()` has been removed. Please use [`console.log()`][] instead.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0027"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0027: `util.puts()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-01-10 18:51:08 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/25377
|
2019-01-07 18:53:58 +01:00
|
|
|
|
description: End-of-Life.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.11.3
|
|
|
|
|
commit: 896b2aa7074fc886efd7dd0a397d694763cac7ce
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-01-07 18:53:58 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-01-07 18:53:58 +01:00
|
|
|
|
`util.puts()` has been removed. Please use [`console.log()`][] instead.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0028"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0028: `util.debug()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-01-10 18:51:08 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/25377
|
2019-01-07 19:19:49 +01:00
|
|
|
|
description: End-of-Life.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.11.3
|
|
|
|
|
commit: 896b2aa7074fc886efd7dd0a397d694763cac7ce
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-01-07 19:19:49 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-01-07 19:19:49 +01:00
|
|
|
|
`util.debug()` has been removed. Please use [`console.error()`][] instead.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0029"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0029: `util.error()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-01-10 18:51:08 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/25377
|
2019-01-07 20:11:47 +01:00
|
|
|
|
description: End-of-Life.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.11.3
|
|
|
|
|
commit: 896b2aa7074fc886efd7dd0a397d694763cac7ce
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-01-07 20:11:47 +01:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2019-01-07 20:11:47 +01:00
|
|
|
|
`util.error()` has been removed. Please use [`console.error()`][] instead.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0030"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0030: `SlowBuffer`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v6.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/5833
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`SlowBuffer`][] class is deprecated. Please use
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`Buffer.allocUnsafeSlow(size)`][] instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0031"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0031: `ecdh.setPublicKey()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v5.2.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/3511
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
|
|
|
|
The [`ecdh.setPublicKey()`][] method is now deprecated as its inclusion in the
|
|
|
|
|
API is not useful.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0032"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0032: `domain` module
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v1.4.2
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/943
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
|
|
|
|
The [`domain`][] module is deprecated and should not be used.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0033"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0033: `EventEmitter.listenerCount()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v3.2.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2349
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`EventEmitter.listenerCount(emitter, eventName)`][] API is
|
2016-12-04 21:47:01 +01:00
|
|
|
|
deprecated. Please use [`emitter.listenerCount(eventName)`][] instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0034"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0034: `fs.exists(path, callback)`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v1.0.0
|
|
|
|
|
pr-url: https://github.com/iojs/io.js/pull/166
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`fs.exists(path, callback)`][] API is deprecated. Please use
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`fs.stat()`][] or [`fs.access()`][] instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0035"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0035: `fs.lchmod(path, mode, callback)`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.4.7
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`fs.lchmod(path, mode, callback)`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0036"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0036: `fs.lchmodSync(path, mode)`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.4.7
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`fs.lchmodSync(path, mode)`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<a id="DEP0037"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0037: `fs.lchown(path, uid, gid, callback)`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.6.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/21498
|
|
|
|
|
description: Deprecation revoked.
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.4.7
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Deprecation revoked
|
|
|
|
|
|
2019-05-29 16:16:49 +02:00
|
|
|
|
The [`fs.lchown(path, uid, gid, callback)`][] API was deprecated. The
|
|
|
|
|
deprecation was revoked because the requisite supporting APIs were added in
|
|
|
|
|
libuv.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
|
|
|
|
|
<a id="DEP0038"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0038: `fs.lchownSync(path, uid, gid)`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.6.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/21498
|
|
|
|
|
description: Deprecation revoked.
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.4.7
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Deprecation revoked
|
|
|
|
|
|
2019-05-29 16:16:49 +02:00
|
|
|
|
The [`fs.lchownSync(path, uid, gid)`][] API was deprecated. The deprecation was
|
|
|
|
|
revoked because the requisite supporting APIs were added in libuv.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
|
2016-12-04 21:47:01 +01:00
|
|
|
|
<a id="DEP0039"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0039: `require.extensions`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.10.6
|
|
|
|
|
commit: 7bd8a5a2a60b75266f89f9a32877d55294a3881c
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`require.extensions`][] property is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0040"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0040: `punycode` module
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v7.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/7941
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`punycode`][] module is deprecated. Please use a userland alternative
|
2016-12-04 21:47:01 +01:00
|
|
|
|
instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0041"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0041: `NODE_REPL_HISTORY_FILE` environment variable
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/13876
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v3.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2224
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-04-11 14:48:10 +02:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2017-06-22 18:47:44 +02:00
|
|
|
|
The `NODE_REPL_HISTORY_FILE` environment variable was removed. Please use
|
|
|
|
|
`NODE_REPL_HISTORY` instead.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0042"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0042: `tls.CryptoStream`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/17882
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v0.11.3
|
|
|
|
|
commit: af80e7bc6e6f33c582eb1f7d37c7f5bbe9f910f7
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-07-30 19:17:51 +02:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-07-30 19:17:51 +02:00
|
|
|
|
The [`tls.CryptoStream`][] class was removed. Please use
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`tls.TLSSocket`][] instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0043"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0043: `tls.SecurePair`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/11349
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version: v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v6.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/6063
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
- version: v0.11.15
|
|
|
|
|
pr-url:
|
|
|
|
|
- https://github.com/nodejs/node-v0.x-archive/pull/8695
|
|
|
|
|
- https://github.com/nodejs/node-v0.x-archive/pull/8700
|
|
|
|
|
description: Deprecation revoked.
|
|
|
|
|
- version: v0.11.3
|
|
|
|
|
commit: af80e7bc6e6f33c582eb1f7d37c7f5bbe9f910f7
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`tls.SecurePair`][] class is deprecated. Please use
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`tls.TLSSocket`][] instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0044"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0044: `util.isArray()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isArray()`][] API is deprecated. Please use `Array.isArray()`
|
2016-12-04 21:47:01 +01:00
|
|
|
|
instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0045"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0045: `util.isBoolean()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isBoolean()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0046"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0046: `util.isBuffer()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isBuffer()`][] API is deprecated. Please use
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`Buffer.isBuffer()`][] instead.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0047"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0047: `util.isDate()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isDate()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0048"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0048: `util.isError()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isError()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0049"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0049: `util.isFunction()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isFunction()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0050"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0050: `util.isNull()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isNull()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0051"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0051: `util.isNullOrUndefined()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isNullOrUndefined()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0052"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0052: `util.isNumber()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isNumber()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0053"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0053 `util.isObject()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isObject()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0054"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0054: `util.isPrimitive()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isPrimitive()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0055"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0055: `util.isRegExp()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isRegExp()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0056"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0056: `util.isString()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isString()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0057"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0057: `util.isSymbol()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isSymbol()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0058"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0058: `util.isUndefined()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version:
|
|
|
|
|
- v4.8.6
|
|
|
|
|
- v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version:
|
|
|
|
|
- v3.3.1
|
|
|
|
|
- v4.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/2447
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.isUndefined()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0059"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0059: `util.log()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v6.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/6161
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util.log()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0060"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0060: `util._extend()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v6.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/4903
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The [`util._extend()`][] API is deprecated.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0061"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0061: `fs.SyncWriteStream`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-08 11:44:11 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/20735
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10467
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version: v7.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/6749
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2018-05-15 02:55:46 +02:00
|
|
|
|
Type: End-of-Life
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
|
|
|
|
The `fs.SyncWriteStream` class was never intended to be a publicly accessible
|
2018-05-15 02:55:46 +02:00
|
|
|
|
API and has been removed. No alternative API is available. Please use a userland
|
|
|
|
|
alternative.
|
2016-12-04 21:47:01 +01:00
|
|
|
|
|
2017-01-24 00:08:30 +01:00
|
|
|
|
<a id="DEP0062"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0062: `node --debug`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10970
|
|
|
|
|
description: Runtime deprecation.
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-01-30 20:29:30 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/25828
|
|
|
|
|
description: End-of-Life.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
-->
|
2017-01-24 00:08:30 +01:00
|
|
|
|
|
2019-02-21 21:45:41 +01:00
|
|
|
|
Type: End-of-Life
|
2017-01-24 00:08:30 +01:00
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
`--debug` activates the legacy V8 debugger interface, which was removed as
|
2017-01-24 00:08:30 +01:00
|
|
|
|
of V8 5.8. It is replaced by Inspector which is activated with `--inspect`
|
|
|
|
|
instead.
|
|
|
|
|
|
2017-02-16 22:10:21 +01:00
|
|
|
|
<a id="DEP0063"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0063: `ServerResponse.prototype.writeHeader()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/11355
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2017-02-16 22:10:21 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The `http` module `ServerResponse.prototype.writeHeader()` API is
|
2017-02-16 22:10:21 +01:00
|
|
|
|
deprecated. Please use `ServerResponse.prototype.writeHead()` instead.
|
|
|
|
|
|
2018-02-06 06:55:16 +01:00
|
|
|
|
The `ServerResponse.prototype.writeHeader()` method was never documented as an
|
|
|
|
|
officially supported API.
|
2017-02-16 22:10:21 +01:00
|
|
|
|
|
2017-02-16 23:30:29 +01:00
|
|
|
|
<a id="DEP0064"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0064: `tls.createSecurePair()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/11349
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version: v6.12.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10116
|
|
|
|
|
description: A deprecation code has been assigned.
|
|
|
|
|
- version: v6.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/6063
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
- version: v0.11.15
|
|
|
|
|
pr-url:
|
|
|
|
|
- https://github.com/nodejs/node-v0.x-archive/pull/8695
|
|
|
|
|
- https://github.com/nodejs/node-v0.x-archive/pull/8700
|
|
|
|
|
description: Deprecation revoked.
|
|
|
|
|
- version: v0.11.3
|
|
|
|
|
commit: af80e7bc6e6f33c582eb1f7d37c7f5bbe9f910f7
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-02-16 23:30:29 +01:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
The `tls.createSecurePair()` API was deprecated in documentation in Node.js
|
|
|
|
|
0.11.3. Users should use `tls.Socket` instead.
|
|
|
|
|
|
2017-02-28 03:45:53 +01:00
|
|
|
|
<a id="DEP0065"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0065: `repl.REPL_MODE_MAGIC` and `NODE_REPL_MODE=magic`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/19187
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/11599
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2017-02-28 03:45:53 +01:00
|
|
|
|
|
2018-03-06 18:32:16 +01:00
|
|
|
|
Type: End-of-Life
|
2017-02-28 03:45:53 +01:00
|
|
|
|
|
|
|
|
|
The `repl` module's `REPL_MODE_MAGIC` constant, used for `replMode` option, has
|
2018-03-06 18:32:16 +01:00
|
|
|
|
been removed. Its behavior has been functionally identical to that of
|
2018-05-04 19:11:02 +02:00
|
|
|
|
`REPL_MODE_SLOPPY` since Node.js 6.0.0, when V8 5.0 was imported. Please use
|
2017-02-28 03:45:53 +01:00
|
|
|
|
`REPL_MODE_SLOPPY` instead.
|
|
|
|
|
|
|
|
|
|
The `NODE_REPL_MODE` environment variable is used to set the underlying
|
2018-03-06 18:32:16 +01:00
|
|
|
|
`replMode` of an interactive `node` session. Its value, `magic`, is also
|
|
|
|
|
removed. Please use `sloppy` instead.
|
2017-02-28 03:45:53 +01:00
|
|
|
|
|
2017-03-06 03:11:32 +01:00
|
|
|
|
<a id="DEP0066"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0066: `OutgoingMessage.prototype._headers, OutgoingMessage.prototype._headerNames`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2018-11-06 16:24:26 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/24167
|
|
|
|
|
description: Runtime deprecation.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10941
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2017-03-06 03:11:32 +01:00
|
|
|
|
|
2018-11-06 16:24:26 +01:00
|
|
|
|
Type: Runtime
|
2017-03-06 03:11:32 +01:00
|
|
|
|
|
2019-05-06 18:31:46 +02:00
|
|
|
|
The `http` module `OutgoingMessage.prototype._headers` and
|
|
|
|
|
`OutgoingMessage.prototype._headerNames` properties are deprecated. Use one of
|
|
|
|
|
the public methods (e.g. `OutgoingMessage.prototype.getHeader()`,
|
|
|
|
|
`OutgoingMessage.prototype.getHeaders()`,
|
|
|
|
|
`OutgoingMessage.prototype.getHeaderNames()`,
|
|
|
|
|
`OutgoingMessage.prototype.hasHeader()`,
|
|
|
|
|
`OutgoingMessage.prototype.removeHeader()`,
|
|
|
|
|
`OutgoingMessage.prototype.setHeader()`) for working with outgoing headers.
|
|
|
|
|
|
|
|
|
|
The `OutgoingMessage.prototype._headers` and
|
|
|
|
|
`OutgoingMessage.prototype._headerNames` properties were never documented as
|
|
|
|
|
officially supported properties.
|
2017-03-06 03:11:32 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0067"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0067: `OutgoingMessage.prototype._renderHeaders`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/10941
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2017-03-06 03:11:32 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
The `http` module `OutgoingMessage.prototype._renderHeaders()` API is
|
2017-03-06 03:11:32 +01:00
|
|
|
|
deprecated.
|
|
|
|
|
|
2018-02-06 06:55:16 +01:00
|
|
|
|
The `OutgoingMessage.prototype._renderHeaders` property was never documented as
|
2017-03-06 03:11:32 +01:00
|
|
|
|
an officially supported API.
|
|
|
|
|
|
2017-03-14 22:20:38 +01:00
|
|
|
|
<a id="DEP0068"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0068: `node debug`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/11441
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-03-14 22:20:38 +01:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
`node debug` corresponds to the legacy CLI debugger which has been replaced with
|
|
|
|
|
a V8-inspector based CLI debugger available through `node inspect`.
|
|
|
|
|
|
2017-05-03 20:38:56 +02:00
|
|
|
|
<a id="DEP0069"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0069: `vm.runInDebugContext(string)`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/13295
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/12815
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version: v8.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/12243
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2017-05-03 20:38:56 +02:00
|
|
|
|
|
2017-11-24 00:13:44 +01:00
|
|
|
|
Type: End-of-Life
|
2017-05-03 20:38:56 +02:00
|
|
|
|
|
2018-03-04 14:46:49 +01:00
|
|
|
|
DebugContext has been removed in V8 and is not available in Node.js 10+.
|
2017-05-03 20:38:56 +02:00
|
|
|
|
|
2018-02-06 06:55:16 +01:00
|
|
|
|
DebugContext was an experimental API.
|
2017-06-14 12:39:53 +02:00
|
|
|
|
|
|
|
|
|
<a id="DEP0070"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0070: `async_hooks.currentId()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/14414
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v8.2.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/13490
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-06-14 12:39:53 +02:00
|
|
|
|
|
2017-07-21 19:24:28 +02:00
|
|
|
|
Type: End-of-Life
|
2017-06-14 12:39:53 +02:00
|
|
|
|
|
|
|
|
|
`async_hooks.currentId()` was renamed to `async_hooks.executionAsyncId()` for
|
|
|
|
|
clarity.
|
|
|
|
|
|
2018-02-06 06:55:16 +01:00
|
|
|
|
This change was made while `async_hooks` was an experimental API.
|
2017-06-14 12:39:53 +02:00
|
|
|
|
|
|
|
|
|
<a id="DEP0071"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0071: `async_hooks.triggerId()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/14414
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v8.2.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/13490
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-06-14 12:39:53 +02:00
|
|
|
|
|
2017-07-21 19:24:28 +02:00
|
|
|
|
Type: End-of-Life
|
2017-06-14 12:39:53 +02:00
|
|
|
|
|
|
|
|
|
`async_hooks.triggerId()` was renamed to `async_hooks.triggerAsyncId()` for
|
|
|
|
|
clarity.
|
|
|
|
|
|
2018-02-06 06:55:16 +01:00
|
|
|
|
This change was made while `async_hooks` was an experimental API.
|
2017-06-14 12:39:53 +02:00
|
|
|
|
|
|
|
|
|
<a id="DEP0072"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0072: `async_hooks.AsyncResource.triggerId()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/14414
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v8.2.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/13490
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-06-14 12:39:53 +02:00
|
|
|
|
|
2017-07-21 19:24:28 +02:00
|
|
|
|
Type: End-of-Life
|
2017-06-14 12:39:53 +02:00
|
|
|
|
|
|
|
|
|
`async_hooks.AsyncResource.triggerId()` was renamed to
|
|
|
|
|
`async_hooks.AsyncResource.triggerAsyncId()` for clarity.
|
|
|
|
|
|
2018-02-06 06:55:16 +01:00
|
|
|
|
This change was made while `async_hooks` was an experimental API.
|
2017-05-03 20:38:56 +02:00
|
|
|
|
|
2017-08-01 22:48:03 +02:00
|
|
|
|
<a id="DEP0073"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0073: Several internal properties of `net.Server`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/17141
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/14449
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-07-24 16:52:38 +02:00
|
|
|
|
|
2017-11-19 22:24:22 +01:00
|
|
|
|
Type: End-of-Life
|
2017-07-24 16:52:38 +02:00
|
|
|
|
|
|
|
|
|
Accessing several internal, undocumented properties of `net.Server` instances
|
2018-05-30 14:56:41 +02:00
|
|
|
|
with inappropriate names is deprecated.
|
2017-07-24 16:52:38 +02:00
|
|
|
|
|
2018-02-06 06:55:16 +01:00
|
|
|
|
As the original API was undocumented and not generally useful for non-internal
|
|
|
|
|
code, no replacement API is provided.
|
2017-07-24 16:52:38 +02:00
|
|
|
|
|
2017-06-14 21:52:15 +02:00
|
|
|
|
<a id="DEP0074"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0074: `REPLServer.bufferedCommand`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/13687
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-06-14 21:52:15 +02:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
The `REPLServer.bufferedCommand` property was deprecated in favor of
|
|
|
|
|
[`REPLServer.clearBufferedCommand()`][].
|
|
|
|
|
|
2017-07-13 20:17:33 +02:00
|
|
|
|
<a id="DEP0075"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0075: `REPLServer.parseREPLKeyword()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/14223
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-07-13 20:17:33 +02:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
`REPLServer.parseREPLKeyword()` was removed from userland visibility.
|
|
|
|
|
|
2017-09-21 18:42:06 +02:00
|
|
|
|
<a id="DEP0076"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0076: `tls.parseCertString()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/14249
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version: v8.6.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/14245
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2017-08-10 05:16:44 +02:00
|
|
|
|
|
2017-09-08 09:58:54 +02:00
|
|
|
|
Type: Runtime
|
2017-08-10 05:16:44 +02:00
|
|
|
|
|
|
|
|
|
`tls.parseCertString()` is a trivial parsing helper that was made public by
|
|
|
|
|
mistake. This function can usually be replaced with:
|
|
|
|
|
|
|
|
|
|
```js
|
|
|
|
|
const querystring = require('querystring');
|
|
|
|
|
querystring.parse(str, '\n', '=');
|
|
|
|
|
```
|
|
|
|
|
|
2018-02-06 06:55:16 +01:00
|
|
|
|
This function is not completely equivalent to `querystring.parse()`. One
|
2017-10-01 04:03:06 +02:00
|
|
|
|
difference is that `querystring.parse()` does url decoding:
|
2017-08-10 05:16:44 +02:00
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
> querystring.parse('%E5%A5%BD=1', '\n', '=');
|
|
|
|
|
{ '好': '1' }
|
|
|
|
|
> tls.parseCertString('%E5%A5%BD=1');
|
|
|
|
|
{ '%E5%A5%BD': '1' }
|
|
|
|
|
```
|
2017-07-13 20:17:33 +02:00
|
|
|
|
|
2017-06-27 19:20:12 +02:00
|
|
|
|
<a id="DEP0077"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0077: `Module._debug()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/13948
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-06-27 19:20:12 +02:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
2018-05-30 14:56:41 +02:00
|
|
|
|
`Module._debug()` is deprecated.
|
2017-06-27 19:20:12 +02:00
|
|
|
|
|
2018-04-02 07:38:48 +02:00
|
|
|
|
The `Module._debug()` function was never documented as an officially
|
2018-02-12 08:31:55 +01:00
|
|
|
|
supported API.
|
2017-06-27 19:20:12 +02:00
|
|
|
|
|
2017-09-01 18:52:18 +02:00
|
|
|
|
<a id="DEP0078"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0078: `REPLServer.turnOffEditorMode()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/15136
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-09-01 18:52:18 +02:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
`REPLServer.turnOffEditorMode()` was removed from userland visibility.
|
|
|
|
|
|
2017-09-26 23:14:21 +02:00
|
|
|
|
<a id="DEP0079"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0079: Custom inspection function on Objects via `.inspect()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-08 11:44:11 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/20722
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/16393
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version: v8.7.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/15631
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2017-09-26 23:14:21 +02:00
|
|
|
|
|
2018-05-14 18:44:30 +02:00
|
|
|
|
Type: End-of-Life
|
2017-09-26 23:14:21 +02:00
|
|
|
|
|
|
|
|
|
Using a property named `inspect` on an object to specify a custom inspection
|
|
|
|
|
function for [`util.inspect()`][] is deprecated. Use [`util.inspect.custom`][]
|
2018-05-04 19:05:44 +02:00
|
|
|
|
instead. For backward compatibility with Node.js prior to version 6.4.0, both
|
2017-09-26 23:14:21 +02:00
|
|
|
|
may be specified.
|
|
|
|
|
|
2017-10-02 21:39:41 +02:00
|
|
|
|
<a id="DEP0080"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0080: `path._makeLong()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/14956
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2017-08-21 07:44:47 +02:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
|
|
|
|
The internal `path._makeLong()` was not intended for public use. However,
|
2018-06-04 20:58:47 +02:00
|
|
|
|
userland modules have found it useful. The internal API is deprecated
|
2017-08-21 07:44:47 +02:00
|
|
|
|
and replaced with an identical, public `path.toNamespacedPath()` method.
|
|
|
|
|
|
2017-10-06 20:06:35 +02:00
|
|
|
|
<a id="DEP0081"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0081: `fs.truncate()` using a file descriptor
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/15990
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-10-06 20:06:35 +02:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
2018-06-04 20:58:47 +02:00
|
|
|
|
`fs.truncate()` `fs.truncateSync()` usage with a file descriptor is
|
2017-10-06 20:06:35 +02:00
|
|
|
|
deprecated. Please use `fs.ftruncate()` or `fs.ftruncateSync()` to work with
|
|
|
|
|
file descriptors.
|
|
|
|
|
|
2017-10-16 23:24:17 +02:00
|
|
|
|
<a id="DEP0082"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0082: `REPLServer.prototype.memory()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v9.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/16242
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-10-16 23:24:17 +02:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
2018-05-04 19:03:45 +02:00
|
|
|
|
`REPLServer.prototype.memory()` is only necessary for the internal mechanics of
|
|
|
|
|
the `REPLServer` itself. Do not use this function.
|
2017-10-16 23:24:17 +02:00
|
|
|
|
|
2017-10-21 19:29:18 +02:00
|
|
|
|
<a id="DEP0083"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0083: Disabling ECDH by setting `ecdhCurve` to `false`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-09-19 19:40:44 +02:00
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/19794
|
|
|
|
|
description: End-of-Life.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version: v9.2.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/16130
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-10-21 19:29:18 +02:00
|
|
|
|
|
2018-09-19 19:40:44 +02:00
|
|
|
|
Type: End-of-Life.
|
2017-10-21 19:29:18 +02:00
|
|
|
|
|
|
|
|
|
The `ecdhCurve` option to `tls.createSecureContext()` and `tls.TLSSocket` could
|
2018-09-19 19:40:44 +02:00
|
|
|
|
be set to `false` to disable ECDH entirely on the server only. This mode was
|
2017-10-21 19:29:18 +02:00
|
|
|
|
deprecated in preparation for migrating to OpenSSL 1.1.0 and consistency with
|
2018-09-19 19:40:44 +02:00
|
|
|
|
the client and is now unsupported. Use the `ciphers` parameter instead.
|
2017-10-21 19:29:18 +02:00
|
|
|
|
|
2017-10-22 21:16:48 +02:00
|
|
|
|
<a id="DEP0084"></a>
|
|
|
|
|
### DEP0084: requiring bundled internal dependencies
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2018-12-19 20:55:52 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/25138
|
|
|
|
|
description: This functionality has been removed.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/16392
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-10-22 21:16:48 +02:00
|
|
|
|
|
2018-12-19 20:55:52 +01:00
|
|
|
|
Type: End-of-Life
|
2017-10-22 21:16:48 +02:00
|
|
|
|
|
|
|
|
|
Since Node.js versions 4.4.0 and 5.2.0, several modules only intended for
|
2018-12-19 20:55:52 +01:00
|
|
|
|
internal usage were mistakenly exposed to user code through `require()`. These
|
|
|
|
|
modules were:
|
2017-10-22 21:16:48 +02:00
|
|
|
|
|
2019-09-13 06:22:29 +02:00
|
|
|
|
* `v8/tools/codemap`
|
|
|
|
|
* `v8/tools/consarray`
|
|
|
|
|
* `v8/tools/csvparser`
|
|
|
|
|
* `v8/tools/logreader`
|
|
|
|
|
* `v8/tools/profile_view`
|
|
|
|
|
* `v8/tools/profile`
|
|
|
|
|
* `v8/tools/SourceMap`
|
|
|
|
|
* `v8/tools/splaytree`
|
|
|
|
|
* `v8/tools/tickprocessor-driver`
|
|
|
|
|
* `v8/tools/tickprocessor`
|
|
|
|
|
* `node-inspect/lib/_inspect` (from 7.6.0)
|
|
|
|
|
* `node-inspect/lib/internal/inspect_client` (from 7.6.0)
|
|
|
|
|
* `node-inspect/lib/internal/inspect_repl` (from 7.6.0)
|
2017-10-22 21:16:48 +02:00
|
|
|
|
|
|
|
|
|
The `v8/*` modules do not have any exports, and if not imported in a specific
|
|
|
|
|
order would in fact throw errors. As such there are virtually no legitimate use
|
|
|
|
|
cases for importing them through `require()`.
|
|
|
|
|
|
|
|
|
|
On the other hand, `node-inspect` may be installed locally through a package
|
|
|
|
|
manager, as it is published on the npm registry under the same name. No source
|
|
|
|
|
code modification is necessary if that is done.
|
|
|
|
|
|
2017-11-12 18:46:55 +01:00
|
|
|
|
<a id="DEP0085"></a>
|
|
|
|
|
### DEP0085: AsyncHooks Sensitive API
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: 10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/17147
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version:
|
|
|
|
|
- v8.10.0
|
|
|
|
|
- v9.4.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/16972
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-11-12 18:46:55 +01:00
|
|
|
|
|
2017-11-22 11:25:03 +01:00
|
|
|
|
Type: End-of-Life
|
2017-11-12 18:46:55 +01:00
|
|
|
|
|
2018-05-04 19:00:19 +02:00
|
|
|
|
The AsyncHooks Sensitive API was never documented and had various minor issues.
|
2019-07-10 00:57:17 +02:00
|
|
|
|
Use the `AsyncResource` API instead. See
|
|
|
|
|
<https://github.com/nodejs/node/issues/15572>.
|
2017-11-12 18:46:55 +01:00
|
|
|
|
|
|
|
|
|
<a id="DEP0086"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0086: Remove `runInAsyncIdScope`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: 10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/17147
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version:
|
|
|
|
|
- v8.10.0
|
|
|
|
|
- v9.4.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/16972
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2017-11-12 18:46:55 +01:00
|
|
|
|
|
2017-11-22 11:25:03 +01:00
|
|
|
|
Type: End-of-Life
|
2017-11-12 18:46:55 +01:00
|
|
|
|
|
2018-04-09 18:30:22 +02:00
|
|
|
|
`runInAsyncIdScope` doesn't emit the `'before'` or `'after'` event and can thus
|
2019-07-10 00:57:17 +02:00
|
|
|
|
cause a lot of issues. See <https://github.com/nodejs/node/issues/14328>.
|
2017-08-21 07:44:47 +02:00
|
|
|
|
|
2017-11-13 21:15:24 +01:00
|
|
|
|
<a id="DEP0089"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0089: `require('assert')`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-08-06 15:06:33 +02:00
|
|
|
|
- version: v12.8.0
|
2019-07-29 16:56:59 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/28892
|
|
|
|
|
description: Deprecation revoked.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v9.9.0
|
|
|
|
|
- v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/17002
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2017-11-13 21:15:24 +01:00
|
|
|
|
|
2019-07-29 16:56:59 +02:00
|
|
|
|
Type: Deprecation revoked
|
2017-11-13 21:15:24 +01:00
|
|
|
|
|
2019-07-29 16:56:59 +02:00
|
|
|
|
Importing assert directly was not recommended as the exposed functions use
|
|
|
|
|
loose equality checks. The deprecation was revoked because use of the `assert`
|
|
|
|
|
module is not discouraged, and the deprecation caused end user confusion.
|
2017-11-13 21:15:24 +01:00
|
|
|
|
|
2018-01-06 15:30:58 +01:00
|
|
|
|
<a id="DEP0090"></a>
|
|
|
|
|
### DEP0090: Invalid GCM authentication tag lengths
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-08 11:44:11 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/17825
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18017
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-01-06 15:30:58 +01:00
|
|
|
|
|
2018-04-11 13:52:51 +02:00
|
|
|
|
Type: End-of-Life
|
2018-01-06 15:30:58 +01:00
|
|
|
|
|
2018-04-11 13:52:51 +02:00
|
|
|
|
Node.js used to support all GCM authentication tag lengths which are accepted by
|
2019-06-06 13:06:09 +02:00
|
|
|
|
OpenSSL when calling [`decipher.setAuthTag()`][]. Beginning with Node.js
|
|
|
|
|
v11.0.0, only authentication tag lengths of 128, 120, 112, 104, 96, 64, and 32
|
|
|
|
|
bits are allowed. Authentication tags of other lengths are invalid per
|
|
|
|
|
[NIST SP 800-38D][].
|
2018-01-06 15:30:58 +01:00
|
|
|
|
|
2018-02-01 02:50:21 +01:00
|
|
|
|
<a id="DEP0091"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0091: `crypto.DEFAULT_ENCODING`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18333
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-01-24 00:58:14 +01:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
The [`crypto.DEFAULT_ENCODING`][] property is deprecated.
|
|
|
|
|
|
2018-02-01 02:50:21 +01:00
|
|
|
|
<a id="DEP0092"></a>
|
|
|
|
|
### DEP0092: Top-level `this` bound to `module.exports`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/16878
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2017-11-08 15:28:34 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
|
|
|
|
Assigning properties to the top-level `this` as an alternative
|
|
|
|
|
to `module.exports` is deprecated. Developers should use `exports`
|
|
|
|
|
or `module.exports` instead.
|
|
|
|
|
|
2018-02-04 19:59:53 +01:00
|
|
|
|
<a id="DEP0093"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0093: `crypto.fips` is deprecated and replaced.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18335
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2018-01-24 01:32:19 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
|
|
|
|
The [`crypto.fips`][] property is deprecated. Please use `crypto.setFips()`
|
|
|
|
|
and `crypto.getFips()` instead.
|
|
|
|
|
|
2018-02-04 19:59:53 +01:00
|
|
|
|
<a id="DEP0094"></a>
|
|
|
|
|
### DEP0094: Using `assert.fail()` with more than one argument.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18418
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-01-28 12:07:18 +01:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
2018-05-04 18:56:45 +02:00
|
|
|
|
Using `assert.fail()` with more than one argument is deprecated. Use
|
|
|
|
|
`assert.fail()` with only one argument or use a different `assert` module
|
|
|
|
|
method.
|
2018-01-28 12:07:18 +01:00
|
|
|
|
|
2018-02-04 19:59:53 +01:00
|
|
|
|
<a id="DEP0095"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0095: `timers.enroll()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18066
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-01-09 19:25:20 +01:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
2018-02-12 08:31:55 +01:00
|
|
|
|
`timers.enroll()` is deprecated. Please use the publicly documented
|
|
|
|
|
[`setTimeout()`][] or [`setInterval()`][] instead.
|
2018-01-09 19:25:20 +01:00
|
|
|
|
|
2018-02-04 19:59:53 +01:00
|
|
|
|
<a id="DEP0096"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0096: `timers.unenroll()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18066
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-01-09 19:25:20 +01:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
2018-02-12 08:31:55 +01:00
|
|
|
|
`timers.unenroll()` is deprecated. Please use the publicly documented
|
|
|
|
|
[`clearTimeout()`][] or [`clearInterval()`][] instead.
|
2018-01-09 19:25:20 +01:00
|
|
|
|
|
2018-02-07 20:05:45 +01:00
|
|
|
|
<a id="DEP0097"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0097: `MakeCallback` with `domain` property
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/17417
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-02-07 20:05:45 +01:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
Users of `MakeCallback` that add the `domain` property to carry context,
|
|
|
|
|
should start using the `async_context` variant of `MakeCallback` or
|
2018-02-26 17:06:50 +01:00
|
|
|
|
`CallbackScope`, or the high-level `AsyncResource` class.
|
2018-02-07 20:05:45 +01:00
|
|
|
|
|
2018-02-02 00:25:41 +01:00
|
|
|
|
<a id="DEP0098"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0098: AsyncHooks Embedder `AsyncResource.emitBefore` and `AsyncResource.emitAfter` APIs
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-03-18 19:56:57 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/26530
|
2019-03-08 16:42:21 +01:00
|
|
|
|
description: End-of-Life
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v8.12.0
|
|
|
|
|
- v9.6.0
|
|
|
|
|
- v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18632
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-02-02 00:25:41 +01:00
|
|
|
|
|
2019-03-08 16:42:21 +01:00
|
|
|
|
Type: End-of-Life
|
2018-02-02 00:25:41 +01:00
|
|
|
|
|
2018-04-08 15:53:47 +02:00
|
|
|
|
The embedded API provided by AsyncHooks exposes `.emitBefore()` and
|
|
|
|
|
`.emitAfter()` methods which are very easy to use incorrectly which can lead
|
|
|
|
|
to unrecoverable errors.
|
2018-02-02 00:25:41 +01:00
|
|
|
|
|
|
|
|
|
Use [`asyncResource.runInAsyncScope()`][] API instead which provides a much
|
|
|
|
|
safer, and more convenient, alternative. See
|
2019-07-10 00:57:17 +02:00
|
|
|
|
<https://github.com/nodejs/node/pull/18513>.
|
2018-02-02 00:25:41 +01:00
|
|
|
|
|
2018-02-16 16:07:23 +01:00
|
|
|
|
<a id="DEP0099"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0099: async context-unaware `node::MakeCallback` C++ APIs
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18632
|
|
|
|
|
description: Compile-time deprecation.
|
|
|
|
|
-->
|
2018-01-25 03:09:53 +01:00
|
|
|
|
|
|
|
|
|
Type: Compile-time
|
|
|
|
|
|
|
|
|
|
Certain versions of `node::MakeCallback` APIs available to native modules are
|
|
|
|
|
deprecated. Please use the versions of the API that accept an `async_context`
|
|
|
|
|
parameter.
|
|
|
|
|
|
2018-02-08 23:50:34 +01:00
|
|
|
|
<a id="DEP0100"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0100: `process.assert()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18666
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version: v0.3.7
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2018-02-08 23:50:34 +01:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
`process.assert()` is deprecated. Please use the [`assert`][] module instead.
|
|
|
|
|
|
|
|
|
|
This was never a documented feature.
|
|
|
|
|
|
2018-02-26 23:38:16 +01:00
|
|
|
|
<a id="DEP0101"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0101: `--with-lttng`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18982
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
-->
|
2018-02-26 23:38:16 +01:00
|
|
|
|
|
|
|
|
|
Type: End-of-Life
|
|
|
|
|
|
2018-05-04 18:53:42 +02:00
|
|
|
|
The `--with-lttng` compile-time option has been removed.
|
2018-02-26 23:38:16 +01:00
|
|
|
|
|
2018-02-15 14:22:57 +01:00
|
|
|
|
<a id="DEP0102"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0102: Using `noAssert` in `Buffer#(read|write)` operations.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18395
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
-->
|
2018-02-15 14:22:57 +01:00
|
|
|
|
|
|
|
|
|
Type: End-of-Life
|
|
|
|
|
|
|
|
|
|
Using the `noAssert` argument has no functionality anymore. All input is going
|
|
|
|
|
to be verified, no matter if it is set to true or not. Skipping the verification
|
|
|
|
|
could lead to hard to find errors and crashes.
|
|
|
|
|
|
2018-03-05 19:02:26 +01:00
|
|
|
|
<a id="DEP0103"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0103: `process.binding('util').is[...]` typechecks
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.9.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/22004
|
|
|
|
|
description: Superseded by [DEP0111](#DEP0111).
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18415
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2018-01-27 22:01:32 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only (supports [`--pending-deprecation`][])
|
|
|
|
|
|
|
|
|
|
Using `process.binding()` in general should be avoided. The type checking
|
|
|
|
|
methods in particular can be replaced by using [`util.types`][].
|
|
|
|
|
|
2018-07-27 17:54:53 +02:00
|
|
|
|
This deprecation has been superseded by the deprecation of the
|
2018-08-01 02:15:45 +02:00
|
|
|
|
`process.binding()` API ([DEP0111](#DEP0111)).
|
2018-07-27 17:54:53 +02:00
|
|
|
|
|
2018-02-25 22:42:10 +01:00
|
|
|
|
<a id="DEP0104"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0104: `process.env` string coercion
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/18990
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2018-02-25 22:42:10 +01:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only (supports [`--pending-deprecation`][])
|
|
|
|
|
|
2018-05-04 18:51:44 +02:00
|
|
|
|
When assigning a non-string property to [`process.env`][], the assigned value is
|
|
|
|
|
implicitly converted to a string. This behavior is deprecated if the assigned
|
|
|
|
|
value is not a string, boolean, or number. In the future, such assignment may
|
|
|
|
|
result in a thrown error. Please convert the property to a string before
|
|
|
|
|
assigning it to `process.env`.
|
2018-02-25 22:42:10 +01:00
|
|
|
|
|
2018-03-14 18:15:41 +01:00
|
|
|
|
<a id="DEP0105"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0105: `decipher.finaltol`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-08 11:44:11 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/19941
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/19353
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-03-14 18:15:41 +01:00
|
|
|
|
|
2018-04-11 14:26:09 +02:00
|
|
|
|
Type: End-of-Life
|
2018-03-14 18:15:41 +01:00
|
|
|
|
|
2018-04-11 14:26:09 +02:00
|
|
|
|
`decipher.finaltol()` has never been documented and was an alias for
|
|
|
|
|
[`decipher.final()`][]. This API has been removed, and it is recommended to use
|
|
|
|
|
[`decipher.final()`][] instead.
|
2018-03-14 18:15:41 +01:00
|
|
|
|
|
2018-03-14 01:54:42 +01:00
|
|
|
|
<a id="DEP0106"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0106: `crypto.createCipher` and `crypto.createDecipher`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-08 11:44:11 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/22089
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/19343
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2018-03-14 01:54:42 +01:00
|
|
|
|
|
2018-08-02 15:23:09 +02:00
|
|
|
|
Type: Runtime
|
2018-03-14 01:54:42 +01:00
|
|
|
|
|
|
|
|
|
Using [`crypto.createCipher()`][] and [`crypto.createDecipher()`][] should be
|
|
|
|
|
avoided as they use a weak key derivation function (MD5 with no salt) and static
|
|
|
|
|
initialization vectors. It is recommended to derive a key using
|
2018-08-02 15:26:39 +02:00
|
|
|
|
[`crypto.pbkdf2()`][] or [`crypto.scrypt()`][] and to use
|
|
|
|
|
[`crypto.createCipheriv()`][] and [`crypto.createDecipheriv()`][] to obtain the
|
|
|
|
|
[`Cipher`][] and [`Decipher`][] objects respectively.
|
2018-03-14 01:54:42 +01:00
|
|
|
|
|
2018-03-17 05:41:41 +01:00
|
|
|
|
<a id="DEP0107"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0107: `tls.convertNPNProtocols()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-08 11:44:11 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/20736
|
|
|
|
|
description: End-of-Life.
|
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/19403
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-03-17 05:41:41 +01:00
|
|
|
|
|
2018-05-15 03:15:30 +02:00
|
|
|
|
Type: End-of-Life
|
2018-03-17 05:41:41 +01:00
|
|
|
|
|
|
|
|
|
This was an undocumented helper function not intended for use outside Node.js
|
|
|
|
|
core and obsoleted by the removal of NPN (Next Protocol Negotiation) support.
|
|
|
|
|
|
2018-03-17 16:59:54 +01:00
|
|
|
|
<a id="DEP0108"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0108: `zlib.bytesRead`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-10-07 03:24:08 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/23308
|
|
|
|
|
description: Runtime deprecation.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
- version: v10.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/19414
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2018-03-17 16:59:54 +01:00
|
|
|
|
|
2018-10-07 03:24:08 +02:00
|
|
|
|
Type: Runtime
|
2018-03-17 16:59:54 +01:00
|
|
|
|
|
|
|
|
|
Deprecated alias for [`zlib.bytesWritten`][]. This original name was chosen
|
|
|
|
|
because it also made sense to interpret the value as the number of bytes
|
|
|
|
|
read by the engine, but is inconsistent with other streams in Node.js that
|
|
|
|
|
expose values under these names.
|
|
|
|
|
|
2018-04-25 02:37:43 +02:00
|
|
|
|
<a id="DEP0109"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0109: `http`, `https`, and `tls` support for invalid URLs
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-08 11:44:11 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/20270
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-04-25 02:37:43 +02:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
Some previously supported (but strictly invalid) URLs were accepted through the
|
|
|
|
|
[`http.request()`][], [`http.get()`][], [`https.request()`][],
|
|
|
|
|
[`https.get()`][], and [`tls.checkServerIdentity()`][] APIs because those were
|
|
|
|
|
accepted by the legacy `url.parse()` API. The mentioned APIs now use the WHATWG
|
|
|
|
|
URL parser that requires strictly valid URLs. Passing an invalid URL is
|
|
|
|
|
deprecated and support will be removed in the future.
|
|
|
|
|
|
2018-06-27 20:59:40 +02:00
|
|
|
|
<a id="DEP0110"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0110: `vm.Script` cached data
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.6.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/20300
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2018-04-25 19:22:20 +02:00
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2018-08-27 19:41:47 +02:00
|
|
|
|
The `produceCachedData` option is deprecated. Use
|
2018-04-25 19:22:20 +02:00
|
|
|
|
[`script.createCachedData()`][] instead.
|
|
|
|
|
|
2018-08-01 02:15:45 +02:00
|
|
|
|
<a id="DEP0111"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0111: `process.binding()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v10.9.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/22004
|
|
|
|
|
description: Documentation-only deprecation.
|
2019-03-13 22:59:36 +01:00
|
|
|
|
- version: v11.12.0
|
2019-02-25 22:28:35 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/26500
|
|
|
|
|
description: Added support for `--pending-deprecation`.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
-->
|
2018-07-27 17:54:53 +02:00
|
|
|
|
|
2019-02-25 22:28:35 +01:00
|
|
|
|
Type: Documentation-only (supports [`--pending-deprecation`][])
|
2018-07-27 17:54:53 +02:00
|
|
|
|
|
2019-01-23 02:23:35 +01:00
|
|
|
|
`process.binding()` is for use by Node.js internal code only.
|
2018-07-27 17:54:53 +02:00
|
|
|
|
|
2018-07-21 16:29:39 +02:00
|
|
|
|
<a id="DEP0112"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0112: `dgram` private APIs
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-08 11:44:11 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/22011
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-07-21 16:29:39 +02:00
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
The `dgram` module previously contained several APIs that were never meant to
|
|
|
|
|
accessed outside of Node.js core: `Socket.prototype._handle`,
|
|
|
|
|
`Socket.prototype._receiving`, `Socket.prototype._bindState`,
|
|
|
|
|
`Socket.prototype._queue`, `Socket.prototype._reuseAddr`,
|
|
|
|
|
`Socket.prototype._healthCheck()`, `Socket.prototype._stopReceiving()`, and
|
|
|
|
|
`dgram._createSocketHandle()`.
|
|
|
|
|
|
2018-08-04 18:13:05 +02:00
|
|
|
|
<a id="DEP0113"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0113: `Cipher.setAuthTag()`, `Decipher.getAuthTag()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-02-21 20:52:45 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/26249
|
|
|
|
|
description: End-of-Life.
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-08 11:44:11 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/22126
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-08-04 18:13:05 +02:00
|
|
|
|
|
2019-02-21 20:52:45 +01:00
|
|
|
|
Type: End-of-Life
|
2018-08-04 18:13:05 +02:00
|
|
|
|
|
2019-02-21 20:52:45 +01:00
|
|
|
|
`Cipher.setAuthTag()` and `Decipher.getAuthTag()` are no longer available. They
|
|
|
|
|
were never documented and would throw when called.
|
2018-08-04 18:13:05 +02:00
|
|
|
|
|
2018-08-24 10:37:45 +02:00
|
|
|
|
<a id="DEP0114"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0114: `crypto._toBuf()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-02-21 21:33:19 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/25338
|
2019-01-04 13:35:00 +01:00
|
|
|
|
description: End-of-Life.
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-08 11:44:11 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/22501
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
2018-08-24 10:37:45 +02:00
|
|
|
|
|
2019-02-21 21:45:41 +01:00
|
|
|
|
Type: End-of-Life
|
2018-08-24 10:37:45 +02:00
|
|
|
|
|
|
|
|
|
The `crypto._toBuf()` function was not designed to be used by modules outside
|
2019-01-04 13:35:00 +01:00
|
|
|
|
of Node.js core and was removed.
|
2018-08-24 10:37:45 +02:00
|
|
|
|
|
2018-08-25 12:04:35 +02:00
|
|
|
|
<a id="DEP0115"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0115: `crypto.prng()`, `crypto.pseudoRandomBytes()`, `crypto.rng()`
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-22 11:45:42 +02:00
|
|
|
|
pr-url:
|
|
|
|
|
- https://github.com/nodejs/node/pull/22519
|
|
|
|
|
- https://github.com/nodejs/node/pull/23017
|
|
|
|
|
description: Added documentation-only deprecation
|
|
|
|
|
with `--pending-deprecation` support.
|
2018-09-08 11:44:11 +02:00
|
|
|
|
-->
|
2018-08-25 12:04:35 +02:00
|
|
|
|
|
2018-09-22 11:45:42 +02:00
|
|
|
|
Type: Documentation-only (supports [`--pending-deprecation`][])
|
2018-08-25 12:04:35 +02:00
|
|
|
|
|
|
|
|
|
In recent versions of Node.js, there is no difference between
|
|
|
|
|
[`crypto.randomBytes()`][] and `crypto.pseudoRandomBytes()`. The latter is
|
|
|
|
|
deprecated along with the undocumented aliases `crypto.prng()` and
|
2018-09-22 11:45:42 +02:00
|
|
|
|
`crypto.rng()` in favor of [`crypto.randomBytes()`][] and may be removed in a
|
2018-08-25 12:04:35 +02:00
|
|
|
|
future release.
|
|
|
|
|
|
2018-09-05 20:33:20 +02:00
|
|
|
|
<a id="DEP0116"></a>
|
|
|
|
|
### DEP0116: Legacy URL API
|
2018-09-08 11:44:11 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: v11.0.0
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/22715
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
2018-09-05 20:33:20 +02:00
|
|
|
|
|
2018-09-09 01:02:49 +02:00
|
|
|
|
Type: Documentation-only
|
2018-09-05 20:33:20 +02:00
|
|
|
|
|
|
|
|
|
The [Legacy URL API][] is deprecated. This includes [`url.format()`][],
|
|
|
|
|
[`url.parse()`][], [`url.resolve()`][], and the [legacy `urlObject`][]. Please
|
|
|
|
|
use the [WHATWG URL API][] instead.
|
|
|
|
|
|
2018-09-12 22:54:43 +02:00
|
|
|
|
<a id="DEP0117"></a>
|
|
|
|
|
### DEP0117: Native crypto handles
|
2018-09-05 11:55:00 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-03-30 11:01:45 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/27011
|
|
|
|
|
description: End-of-Life.
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-05 11:55:00 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/22747
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
2019-03-30 11:01:45 +01:00
|
|
|
|
Type: End-of-Life
|
2018-09-05 11:55:00 +02:00
|
|
|
|
|
|
|
|
|
Previous versions of Node.js exposed handles to internal native objects through
|
|
|
|
|
the `_handle` property of the `Cipher`, `Decipher`, `DiffieHellman`,
|
|
|
|
|
`DiffieHellmanGroup`, `ECDH`, `Hash`, `Hmac`, `Sign`, and `Verify` classes.
|
2019-03-30 11:01:45 +01:00
|
|
|
|
The `_handle` property has been removed because improper use of the native
|
|
|
|
|
object can lead to crashing the application.
|
2018-09-05 20:33:20 +02:00
|
|
|
|
|
2018-09-30 12:17:36 +02:00
|
|
|
|
<a id="DEP0118"></a>
|
2020-01-12 16:20:36 +01:00
|
|
|
|
### DEP0118: `dns.lookup()` support for a falsy host name
|
2018-09-30 12:17:36 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-09-30 12:17:36 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/23173
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
2020-01-12 16:20:36 +01:00
|
|
|
|
Previous versions of Node.js supported `dns.lookup()` with a falsy host name
|
2018-09-30 12:17:36 +02:00
|
|
|
|
like `dns.lookup(false)` due to backward compatibility.
|
|
|
|
|
This behavior is undocumented and is thought to be unused in real world apps.
|
|
|
|
|
It will become an error in future versions of Node.js.
|
|
|
|
|
|
2018-10-12 20:11:44 +02:00
|
|
|
|
<a id="DEP0119"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0119: `process.binding('uv').errname()` private API
|
2018-10-21 21:37:26 +02:00
|
|
|
|
<!-- YAML
|
2018-10-12 20:11:44 +02:00
|
|
|
|
changes:
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-10-12 20:11:44 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/23597
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Documentation-only (supports [`--pending-deprecation`][])
|
|
|
|
|
|
2018-12-30 00:28:02 +01:00
|
|
|
|
`process.binding('uv').errname()` is deprecated. Please use
|
|
|
|
|
[`util.getSystemErrorName()`][] instead.
|
2018-10-12 20:11:44 +02:00
|
|
|
|
|
2018-10-21 21:37:26 +02:00
|
|
|
|
<a id="DEP0120"></a>
|
|
|
|
|
### DEP0120: Windows Performance Counter Support
|
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2018-12-06 05:50:28 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/24862
|
|
|
|
|
description: End-of-Life.
|
2018-10-03 01:01:19 +02:00
|
|
|
|
- version: v11.0.0
|
2018-10-21 21:37:26 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/22485
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
2018-12-06 05:50:28 +01:00
|
|
|
|
Type: End-of-Life
|
2018-10-21 21:37:26 +02:00
|
|
|
|
|
|
|
|
|
Windows Performance Counter support has been removed from Node.js. The
|
|
|
|
|
undocumented `COUNTER_NET_SERVER_CONNECTION()`,
|
|
|
|
|
`COUNTER_NET_SERVER_CONNECTION_CLOSE()`, `COUNTER_HTTP_SERVER_REQUEST()`,
|
|
|
|
|
`COUNTER_HTTP_SERVER_RESPONSE()`, `COUNTER_HTTP_CLIENT_REQUEST()`, and
|
|
|
|
|
`COUNTER_HTTP_CLIENT_RESPONSE()` functions have been deprecated.
|
|
|
|
|
|
2018-10-25 21:27:20 +02:00
|
|
|
|
<a id="DEP0121"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0121: `net._setSimultaneousAccepts()`
|
2018-10-19 20:21:42 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2018-10-19 20:21:42 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/23760
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
2019-05-29 15:26:40 +02:00
|
|
|
|
Type: Runtime
|
|
|
|
|
|
2018-10-19 20:21:42 +02:00
|
|
|
|
The undocumented `net._setSimultaneousAccepts()` function was originally
|
|
|
|
|
intended for debugging and performance tuning when using the `child_process`
|
|
|
|
|
and `cluster` modules on Windows. The function is not generally useful and
|
|
|
|
|
is being removed. See discussion here:
|
2020-04-06 05:26:24 +02:00
|
|
|
|
<https://github.com/nodejs/node/issues/18391>
|
2018-10-12 20:11:44 +02:00
|
|
|
|
|
2018-10-22 21:17:06 +02:00
|
|
|
|
<a id="DEP0122"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0122: `tls` `Server.prototype.setOptions()`
|
2018-10-22 21:17:06 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2018-10-22 21:17:06 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/23820
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
Please use `Server.prototype.setSecureContext()` instead.
|
|
|
|
|
|
2018-01-13 00:36:21 +01:00
|
|
|
|
<a id="DEP0123"></a>
|
|
|
|
|
### DEP0123: setting the TLS ServerName to an IP address
|
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2018-11-17 17:58:23 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/23329
|
2018-01-13 00:36:21 +01:00
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
Setting the TLS ServerName to an IP address is not permitted by
|
|
|
|
|
[RFC 6066][]. This will be ignored in a future version.
|
|
|
|
|
|
2019-03-01 01:53:14 +01:00
|
|
|
|
<a id="DEP0124"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0124: using `REPLServer.rli`
|
2019-01-21 01:08:22 +01:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-01-21 01:08:22 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/26260
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
This property is a reference to the instance itself.
|
|
|
|
|
|
2019-03-07 12:31:59 +01:00
|
|
|
|
<a id="DEP0125"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0125: `require('_stream_wrap')`
|
2019-02-21 19:42:04 +01:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-02-21 19:42:04 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/26245
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
The `_stream_wrap` module is deprecated.
|
|
|
|
|
|
2019-03-18 23:56:49 +01:00
|
|
|
|
<a id="DEP0126"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0126: `timers.active()`
|
2019-03-18 23:56:49 +01:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-04-10 00:55:02 +02:00
|
|
|
|
- version: v11.14.0
|
2019-03-18 23:56:49 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/26760
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
The previously undocumented `timers.active()` is deprecated.
|
|
|
|
|
Please use the publicly documented [`timeout.refresh()`][] instead.
|
|
|
|
|
If re-referencing the timeout is necessary, [`timeout.ref()`][] can be used
|
|
|
|
|
with no performance impact since Node.js 10.
|
|
|
|
|
|
|
|
|
|
<a id="DEP0127"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0127: `timers._unrefActive()`
|
2019-03-18 23:56:49 +01:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-04-10 00:55:02 +02:00
|
|
|
|
- version: v11.14.0
|
2019-03-18 23:56:49 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/26760
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
The previously undocumented and "private" `timers._unrefActive()` is deprecated.
|
|
|
|
|
Please use the publicly documented [`timeout.refresh()`][] instead.
|
|
|
|
|
If unreferencing the timeout is necessary, [`timeout.unref()`][] can be used
|
|
|
|
|
with no performance impact since Node.js 10.
|
|
|
|
|
|
2019-03-20 17:00:57 +01:00
|
|
|
|
<a id="DEP0128"></a>
|
|
|
|
|
### DEP0128: modules with an invalid `main` entry and an `index.js` file
|
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-03-22 14:19:46 +01:00
|
|
|
|
- version: v12.0.0
|
2019-03-20 17:00:57 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/26823
|
|
|
|
|
description: Documentation-only.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Documentation-only (supports [`--pending-deprecation`][])
|
|
|
|
|
|
|
|
|
|
Modules that have an invalid `main` entry (e.g., `./does-not-exist.js`) and
|
|
|
|
|
also have an `index.js` file in the top level directory will resolve the
|
|
|
|
|
`index.js` file. That is deprecated and is going to throw an error in future
|
|
|
|
|
Node.js versions.
|
|
|
|
|
|
2019-04-10 01:42:13 +02:00
|
|
|
|
<a id="DEP0129"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0129: `ChildProcess._channel`
|
2019-03-29 15:36:57 +01:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-09-09 14:32:18 +02:00
|
|
|
|
- version: v13.0.0
|
2019-05-29 15:22:52 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/27949
|
|
|
|
|
description: Runtime deprecation.
|
2019-04-10 00:55:02 +02:00
|
|
|
|
- version: v11.14.0
|
2019-03-29 15:36:57 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/26982
|
|
|
|
|
description: Documentation-only.
|
|
|
|
|
-->
|
|
|
|
|
|
2019-05-29 15:22:52 +02:00
|
|
|
|
Type: Runtime
|
2019-03-29 15:36:57 +01:00
|
|
|
|
|
|
|
|
|
The `_channel` property of child process objects returned by `spawn()` and
|
|
|
|
|
similar functions is not intended for public use. Use `ChildProcess.channel`
|
|
|
|
|
instead.
|
|
|
|
|
|
2019-04-25 06:29:22 +02:00
|
|
|
|
<a id="DEP0130"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0130: `Module.createRequireFromPath()`
|
2019-04-25 06:29:22 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-09-09 14:32:18 +02:00
|
|
|
|
- version: v13.0.0
|
2019-05-29 15:59:08 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/27951
|
|
|
|
|
description: Runtime deprecation.
|
2019-05-06 14:40:25 +02:00
|
|
|
|
- version: v12.2.0
|
2019-04-25 06:29:22 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/27405
|
|
|
|
|
description: Documentation-only.
|
|
|
|
|
-->
|
|
|
|
|
|
2019-05-29 15:59:08 +02:00
|
|
|
|
Type: Runtime
|
2019-04-25 06:29:22 +02:00
|
|
|
|
|
2019-05-29 16:22:57 +02:00
|
|
|
|
Module.createRequireFromPath() is deprecated. Please use
|
|
|
|
|
[`module.createRequire()`][] instead.
|
2019-04-25 06:29:22 +02:00
|
|
|
|
|
2019-05-09 21:27:10 +02:00
|
|
|
|
<a id="DEP0131"></a>
|
|
|
|
|
### DEP0131: Legacy HTTP parser
|
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-09-09 14:32:18 +02:00
|
|
|
|
- version: v13.0.0
|
2019-09-17 14:17:08 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/29589
|
|
|
|
|
description: This feature has been removed.
|
2019-05-21 13:49:35 +02:00
|
|
|
|
- version: v12.3.0
|
2019-05-09 21:27:10 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/27498
|
|
|
|
|
description: Documentation-only.
|
|
|
|
|
-->
|
|
|
|
|
|
2019-09-17 14:17:08 +02:00
|
|
|
|
Type: End-of-Life
|
2019-05-09 21:27:10 +02:00
|
|
|
|
|
|
|
|
|
The legacy HTTP parser, used by default in versions of Node.js prior to 12.0.0,
|
2019-09-09 14:32:18 +02:00
|
|
|
|
is deprecated and has been removed in v13.0.0. Prior to v13.0.0, the
|
2019-09-17 14:17:08 +02:00
|
|
|
|
`--http-parser=legacy` command-line flag could be used to revert to using the
|
|
|
|
|
legacy parser.
|
2019-05-09 21:27:10 +02:00
|
|
|
|
|
2019-06-17 21:31:37 +02:00
|
|
|
|
<a id="DEP0132"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0132: `worker.terminate()` with callback
|
worker: refactor `worker.terminate()`
At the collaborator summit in Berlin, the behaviour of
`worker.terminate()` was discussed.
In particular, switching from a callback-based to a Promise-based API
was suggested. While investigating that possibility later, it was
discovered that `.terminate()` was unintentionally synchronous up
until now (including calling its callback synchronously).
Also, the topic of its stability has been brought up. I have performed
two manual reviews of the native codebase for compatibility with
`.terminate()`, and performed some manual fuzz testing with the test
suite. At this point, bugs with `.terminate()` should, in my opinion,
be treated like bugs in other Node.js features.
(It is possible to make Node.js crash with `.terminate()` by messing
with internals and/or built-in prototype objects, but that is already
the case without `.terminate()` as well.)
This commit:
- Makes `.terminate()` an asynchronous operation.
- Makes `.terminate()` return a `Promise`.
- Runtime-deprecates passing a callback.
- Removes a warning about its stability from the documentation.
- Eliminates an unnecessary extra function from the C++ code.
A possible alternative to returning a `Promise` would be to keep the
method synchronous and just drop the callback. Generally, providing
an asynchronous API does provide us with a bit more flexibility.
Refs: https://github.com/nodejs/summit/issues/141
PR-URL: https://github.com/nodejs/node/pull/28021
Reviewed-By: Michaël Zasso <targos@protonmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl>
Reviewed-By: Tiancheng "Timothy" Gu <timothygu99@gmail.com>
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
2019-06-02 15:09:57 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-06-17 21:31:37 +02:00
|
|
|
|
- version: v12.5.0
|
worker: refactor `worker.terminate()`
At the collaborator summit in Berlin, the behaviour of
`worker.terminate()` was discussed.
In particular, switching from a callback-based to a Promise-based API
was suggested. While investigating that possibility later, it was
discovered that `.terminate()` was unintentionally synchronous up
until now (including calling its callback synchronously).
Also, the topic of its stability has been brought up. I have performed
two manual reviews of the native codebase for compatibility with
`.terminate()`, and performed some manual fuzz testing with the test
suite. At this point, bugs with `.terminate()` should, in my opinion,
be treated like bugs in other Node.js features.
(It is possible to make Node.js crash with `.terminate()` by messing
with internals and/or built-in prototype objects, but that is already
the case without `.terminate()` as well.)
This commit:
- Makes `.terminate()` an asynchronous operation.
- Makes `.terminate()` return a `Promise`.
- Runtime-deprecates passing a callback.
- Removes a warning about its stability from the documentation.
- Eliminates an unnecessary extra function from the C++ code.
A possible alternative to returning a `Promise` would be to keep the
method synchronous and just drop the callback. Generally, providing
an asynchronous API does provide us with a bit more flexibility.
Refs: https://github.com/nodejs/summit/issues/141
PR-URL: https://github.com/nodejs/node/pull/28021
Reviewed-By: Michaël Zasso <targos@protonmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl>
Reviewed-By: Tiancheng "Timothy" Gu <timothygu99@gmail.com>
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
2019-06-02 15:09:57 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/28021
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
Passing a callback to [`worker.terminate()`][] is deprecated. Use the returned
|
|
|
|
|
`Promise` instead, or a listener to the worker’s `'exit'` event.
|
|
|
|
|
|
2019-08-17 17:30:35 +02:00
|
|
|
|
<a id="DEP0133"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0133: `http` `connection`
|
2019-08-06 13:56:52 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-10-10 14:31:33 +02:00
|
|
|
|
- version: v12.12.0
|
2019-08-06 13:56:52 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/29015
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
2019-10-02 06:31:57 +02:00
|
|
|
|
Prefer [`response.socket`][] over [`response.connection`][] and
|
|
|
|
|
[`request.socket`][] over [`request.connection`][].
|
2019-08-06 13:56:52 +02:00
|
|
|
|
|
2019-10-03 00:39:38 +02:00
|
|
|
|
<a id="DEP0134"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0134: `process._tickCallback`
|
2019-09-30 19:56:26 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-10-10 14:31:33 +02:00
|
|
|
|
- version: v12.12.0
|
2019-09-30 19:56:26 +02:00
|
|
|
|
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.
|
|
|
|
|
|
2019-10-14 17:39:27 +02:00
|
|
|
|
<a id="DEP0135"></a>
|
|
|
|
|
### DEP0135: `WriteStream.open()` and `ReadStream.open()` are internal
|
2019-08-09 09:01:43 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2019-09-09 14:32:18 +02:00
|
|
|
|
- version: v13.0.0
|
2019-08-09 09:01:43 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/29061
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
[`WriteStream.open()`][] and [`ReadStream.open()`][] are undocumented internal
|
|
|
|
|
APIs that do not make sense to use in userland. File streams should always be
|
|
|
|
|
opened through their corresponding factory methods [`fs.createWriteStream()`][]
|
|
|
|
|
and [`fs.createReadStream()`][]) or by passing a file descriptor in options.
|
|
|
|
|
|
2019-07-14 16:59:25 +02:00
|
|
|
|
<a id="DEP0136"></a>
|
2019-12-24 02:21:47 +01:00
|
|
|
|
### DEP0136: `http` `finished`
|
2019-07-14 16:59:25 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2020-04-24 18:43:06 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v13.4.0
|
|
|
|
|
- v12.16.0
|
2019-07-14 16:59:25 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/28679
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
|
|
|
|
[`response.finished`][] indicates whether [`response.end()`][] has been
|
|
|
|
|
called, not whether `'finish'` has been emitted and the underlying data
|
|
|
|
|
is flushed.
|
|
|
|
|
|
|
|
|
|
Use [`response.writableFinished`][] or [`response.writableEnded`][]
|
|
|
|
|
accordingly instead to avoid the ambigiuty.
|
|
|
|
|
|
|
|
|
|
To maintain existing behaviour `response.finished` should be replaced with
|
|
|
|
|
`response.writableEnded`.
|
|
|
|
|
|
2020-02-07 16:07:02 +01:00
|
|
|
|
<a id="DEP0137"></a>
|
|
|
|
|
### DEP0137: Closing fs.FileHandle on garbage collection
|
2019-06-23 15:35:04 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2020-03-10 18:16:08 +01:00
|
|
|
|
- version: v14.0.0
|
2019-06-23 15:35:04 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/28396
|
|
|
|
|
description: Runtime deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Runtime
|
|
|
|
|
|
|
|
|
|
Allowing a [`fs.FileHandle`][] object to be closed on garbage collection is
|
|
|
|
|
deprecated. In the future, doing so may result in a thrown error that will
|
|
|
|
|
terminate the process.
|
|
|
|
|
|
|
|
|
|
Please ensure that all `fs.FileHandle` objects are explicitly closed using
|
|
|
|
|
`FileHandle.prototype.close()` when the `fs.FileHandle` is no longer needed:
|
|
|
|
|
|
|
|
|
|
```js
|
|
|
|
|
const fsPromises = require('fs').promises;
|
|
|
|
|
async function openAndClose() {
|
|
|
|
|
let filehandle;
|
|
|
|
|
try {
|
|
|
|
|
filehandle = await fsPromises.open('thefile.txt', 'r');
|
|
|
|
|
} finally {
|
|
|
|
|
if (filehandle !== undefined)
|
|
|
|
|
await filehandle.close();
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
2020-03-12 19:18:09 +01:00
|
|
|
|
<a id="DEP0138"></a>
|
|
|
|
|
### DEP0138: `process.mainModule`
|
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2020-03-10 18:16:08 +01:00
|
|
|
|
- version: v14.0.0
|
2020-03-12 19:18:09 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/32232
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
|
|
|
|
[`process.mainModule`][] is a CommonJS-only feature while `process` global
|
|
|
|
|
object is shared with non-CommonJS environment. Its use within ECMAScript
|
|
|
|
|
modules is unsupported.
|
|
|
|
|
|
|
|
|
|
It is deprecated in favor of [`require.main`][], because it serves the same
|
|
|
|
|
purpose and is only available on CommonJS environment.
|
|
|
|
|
|
2020-03-26 05:55:39 +01:00
|
|
|
|
<a id="DEP0139"></a>
|
|
|
|
|
### DEP0139: `process.umask()` with no arguments
|
2020-03-26 06:07:31 +01:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2020-03-10 18:16:08 +01:00
|
|
|
|
- version: v14.0.0
|
2020-03-26 06:07:31 +01:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/32499
|
2020-03-26 05:55:39 +01:00
|
|
|
|
description: Runtime deprecation.
|
2020-03-26 06:07:31 +01:00
|
|
|
|
-->
|
|
|
|
|
|
2020-03-26 05:55:39 +01:00
|
|
|
|
Type: Runtime
|
2020-03-26 06:07:31 +01:00
|
|
|
|
|
2020-04-08 01:17:14 +02:00
|
|
|
|
Calling `process.umask()` with no argument causes the process-wide umask to be
|
2020-03-26 06:07:31 +01:00
|
|
|
|
written twice. This introduces a race condition between threads, and is a
|
|
|
|
|
potential security vulnerability. There is no safe, cross-platform alternative
|
|
|
|
|
API.
|
|
|
|
|
|
2020-04-28 00:36:43 +02:00
|
|
|
|
<a id="DEP0140"></a>
|
|
|
|
|
### DEP0140: Use `request.destroy()` instead of `request.abort()`
|
2020-04-13 11:02:03 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
2020-04-28 13:54:04 +02:00
|
|
|
|
- version:
|
|
|
|
|
- v14.1.0
|
|
|
|
|
- v13.14.0
|
2020-04-13 11:02:03 +02:00
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/32807
|
|
|
|
|
description: Documentation-only deprecation.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
|
|
|
|
Use [`request.destroy()`][] instead of [`request.abort()`][].
|
|
|
|
|
|
2020-05-16 12:28:31 +02:00
|
|
|
|
<a id="DEP0141"></a>
|
|
|
|
|
### DEP0141: `repl.inputStream` and `repl.outputStream`
|
2020-05-08 00:20:08 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: REPLACEME
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/33294
|
|
|
|
|
description: Documentation-only (supports [`--pending-deprecation`][]).
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Documentation-only (supports [`--pending-deprecation`][])
|
|
|
|
|
|
|
|
|
|
The `repl` module exported the input and output stream twice. Use `.input`
|
|
|
|
|
instead of `.inputStream` and `.output` instead of `.outputStream`.
|
|
|
|
|
|
2020-05-16 12:28:31 +02:00
|
|
|
|
<a id="DEP0142"></a>
|
|
|
|
|
### DEP0142: `repl._builtinLibs`
|
2020-05-08 00:35:15 +02:00
|
|
|
|
<!-- YAML
|
|
|
|
|
changes:
|
|
|
|
|
- version: REPLACEME
|
|
|
|
|
pr-url: https://github.com/nodejs/node/pull/33294
|
|
|
|
|
description: Documentation-only (supports [`--pending-deprecation`][]).
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
Type: Documentation-only
|
|
|
|
|
|
|
|
|
|
The `repl` module exports a `_builtinLibs` property that contains an array with
|
|
|
|
|
native modules. It was incomplete so far and instead it's better to rely upon
|
|
|
|
|
`require('module').builtinModules`.
|
|
|
|
|
|
2018-01-29 18:23:09 +01:00
|
|
|
|
[`--pending-deprecation`]: cli.html#cli_pending_deprecation
|
2019-07-10 18:26:50 +02:00
|
|
|
|
[`--throw-deprecation`]: cli.html#cli_throw_deprecation
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`Buffer.allocUnsafeSlow(size)`]: buffer.html#buffer_class_method_buffer_allocunsafeslow_size
|
|
|
|
|
[`Buffer.from(array)`]: buffer.html#buffer_class_method_buffer_from_array
|
|
|
|
|
[`Buffer.from(buffer)`]: buffer.html#buffer_class_method_buffer_from_buffer
|
2017-05-08 18:30:13 +02:00
|
|
|
|
[`Buffer.isBuffer()`]: buffer.html#buffer_class_method_buffer_isbuffer_obj
|
2018-03-14 01:54:42 +01:00
|
|
|
|
[`Cipher`]: crypto.html#crypto_class_cipher
|
|
|
|
|
[`Decipher`]: crypto.html#crypto_class_decipher
|
2017-05-08 18:30:13 +02:00
|
|
|
|
[`EventEmitter.listenerCount(emitter, eventName)`]: events.html#events_eventemitter_listenercount_emitter_eventname
|
2018-11-27 20:49:21 +01:00
|
|
|
|
[`REPLServer.clearBufferedCommand()`]: repl.html#repl_replserver_clearbufferedcommand
|
2019-08-09 09:01:43 +02:00
|
|
|
|
[`ReadStream.open()`]: fs.html#fs_class_fs_readstream
|
2017-05-08 18:30:13 +02:00
|
|
|
|
[`Server.connections`]: net.html#net_server_connections
|
|
|
|
|
[`Server.getConnections()`]: net.html#net_server_getconnections_callback
|
|
|
|
|
[`Server.listen({fd: <number>})`]: net.html#net_server_listen_handle_backlog_callback
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`SlowBuffer`]: buffer.html#buffer_class_slowbuffer
|
2019-08-09 09:01:43 +02:00
|
|
|
|
[`WriteStream.open()`]: fs.html#fs_class_fs_writestream
|
2018-11-27 20:49:21 +01:00
|
|
|
|
[`assert`]: assert.html
|
2018-02-02 00:25:41 +01:00
|
|
|
|
[`asyncResource.runInAsyncScope()`]: async_hooks.html#async_hooks_asyncresource_runinasyncscope_fn_thisarg_args
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`child_process`]: child_process.html
|
2018-11-27 20:49:21 +01:00
|
|
|
|
[`clearInterval()`]: timers.html#timers_clearinterval_timeout
|
|
|
|
|
[`clearTimeout()`]: timers.html#timers_cleartimeout_timeout
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`console.error()`]: console.html#console_console_error_data_args
|
|
|
|
|
[`console.log()`]: console.html#console_console_log_data_args
|
2018-11-27 20:49:21 +01:00
|
|
|
|
[`crypto.DEFAULT_ENCODING`]: crypto.html#crypto_crypto_default_encoding
|
2018-03-14 01:54:42 +01:00
|
|
|
|
[`crypto.createCipher()`]: crypto.html#crypto_crypto_createcipher_algorithm_password_options
|
|
|
|
|
[`crypto.createCipheriv()`]: crypto.html#crypto_crypto_createcipheriv_algorithm_key_iv_options
|
|
|
|
|
[`crypto.createDecipher()`]: crypto.html#crypto_crypto_createdecipher_algorithm_password_options
|
|
|
|
|
[`crypto.createDecipheriv()`]: crypto.html#crypto_crypto_createdecipheriv_algorithm_key_iv_options
|
2018-01-24 01:32:19 +01:00
|
|
|
|
[`crypto.fips`]: crypto.html#crypto_crypto_fips
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`crypto.pbkdf2()`]: crypto.html#crypto_crypto_pbkdf2_password_salt_iterations_keylen_digest_callback
|
2018-08-25 12:04:35 +02:00
|
|
|
|
[`crypto.randomBytes()`]: crypto.html#crypto_crypto_randombytes_size_callback
|
2018-08-02 15:26:39 +02:00
|
|
|
|
[`crypto.scrypt()`]: crypto.html#crypto_crypto_scrypt_password_salt_keylen_options_callback
|
2018-03-14 18:15:41 +01:00
|
|
|
|
[`decipher.final()`]: crypto.html#crypto_decipher_final_outputencoding
|
2018-01-06 15:30:58 +01:00
|
|
|
|
[`decipher.setAuthTag()`]: crypto.html#crypto_decipher_setauthtag_buffer
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`domain`]: domain.html
|
2017-06-06 11:00:32 +02:00
|
|
|
|
[`ecdh.setPublicKey()`]: crypto.html#crypto_ecdh_setpublickey_publickey_encoding
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`emitter.listenerCount(eventName)`]: events.html#events_emitter_listenercount_eventname
|
2019-06-23 15:35:04 +02:00
|
|
|
|
[`fs.FileHandle`]: fs.html#fs_class_filehandle
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`fs.access()`]: fs.html#fs_fs_access_path_mode_callback
|
2019-08-09 09:01:43 +02:00
|
|
|
|
[`fs.createReadStream()`]: fs.html#fs_fs_createreadstream_path_options
|
|
|
|
|
[`fs.createWriteStream()`]: fs.html#fs_fs_createwritestream_path_options
|
2017-05-08 18:30:13 +02:00
|
|
|
|
[`fs.exists(path, callback)`]: fs.html#fs_fs_exists_path_callback
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`fs.lchmod(path, mode, callback)`]: fs.html#fs_fs_lchmod_path_mode_callback
|
|
|
|
|
[`fs.lchmodSync(path, mode)`]: fs.html#fs_fs_lchmodsync_path_mode
|
2018-09-08 11:44:11 +02:00
|
|
|
|
[`fs.lchown(path, uid, gid, callback)`]: fs.html#fs_fs_lchown_path_uid_gid_callback
|
|
|
|
|
[`fs.lchownSync(path, uid, gid)`]: fs.html#fs_fs_lchownsync_path_uid_gid
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`fs.read()`]: fs.html#fs_fs_read_fd_buffer_offset_length_position_callback
|
|
|
|
|
[`fs.readSync()`]: fs.html#fs_fs_readsync_fd_buffer_offset_length_position
|
2018-07-01 23:38:05 +02:00
|
|
|
|
[`fs.stat()`]: fs.html#fs_fs_stat_path_options_callback
|
2018-04-25 02:37:43 +02:00
|
|
|
|
[`http.get()`]: http.html#http_http_get_options_callback
|
|
|
|
|
[`http.request()`]: http.html#http_http_request_options_callback
|
|
|
|
|
[`https.get()`]: https.html#https_https_get_options_callback
|
|
|
|
|
[`https.request()`]: https.html#https_https_request_options_callback
|
2019-04-25 06:29:22 +02:00
|
|
|
|
[`module.createRequire()`]: modules.html#modules_module_createrequire_filename
|
2018-12-30 02:30:48 +01:00
|
|
|
|
[`os.networkInterfaces()`]: os.html#os_os_networkinterfaces
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`os.tmpdir()`]: os.html#os_os_tmpdir
|
2018-02-25 22:42:10 +01:00
|
|
|
|
[`process.env`]: process.html#process_process_env
|
2020-03-12 19:18:09 +01:00
|
|
|
|
[`process.mainModule`]: process.html#process_process_mainmodule
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`punycode`]: punycode.html
|
2017-09-09 13:09:28 +02:00
|
|
|
|
[`require.extensions`]: modules.html#modules_require_extensions
|
2020-03-12 19:18:09 +01:00
|
|
|
|
[`require.main`]: modules.html#modules_accessing_the_main_module
|
2020-04-13 11:02:03 +02:00
|
|
|
|
[`request.abort()`]: http.html#http_request_abort
|
2019-08-06 13:56:52 +02:00
|
|
|
|
[`request.socket`]: http.html#http_request_socket
|
|
|
|
|
[`request.connection`]: http.html#http_request_connection
|
2020-04-13 11:02:03 +02:00
|
|
|
|
[`request.destroy()`]: http.html#http_request_destroy_error
|
2019-08-06 13:56:52 +02:00
|
|
|
|
[`response.socket`]: http.html#http_response_socket
|
|
|
|
|
[`response.connection`]: http.html#http_response_connection
|
2019-07-14 16:59:25 +02:00
|
|
|
|
[`response.end()`]: http.html#http_response_end_data_encoding_callback
|
|
|
|
|
[`response.finished`]: #http_response_finished
|
|
|
|
|
[`response.writableFinished`]: #http_response_writablefinished
|
|
|
|
|
[`response.writableEnded`]: #http_response_writableended
|
2018-06-27 20:59:40 +02:00
|
|
|
|
[`script.createCachedData()`]: vm.html#vm_script_createcacheddata
|
2018-01-09 19:25:20 +01:00
|
|
|
|
[`setInterval()`]: timers.html#timers_setinterval_callback_delay_args
|
|
|
|
|
[`setTimeout()`]: timers.html#timers_settimeout_callback_delay_args
|
2019-03-18 23:56:49 +01:00
|
|
|
|
[`timeout.ref()`]: timers.html#timers_timeout_ref
|
|
|
|
|
[`timeout.refresh()`]: timers.html#timers_timeout_refresh
|
|
|
|
|
[`timeout.unref()`]: timers.html#timers_timeout_unref
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`tls.CryptoStream`]: tls.html#tls_class_cryptostream
|
|
|
|
|
[`tls.SecureContext`]: tls.html#tls_tls_createsecurecontext_options
|
2017-05-08 18:30:13 +02:00
|
|
|
|
[`tls.SecurePair`]: tls.html#tls_class_securepair
|
|
|
|
|
[`tls.TLSSocket`]: tls.html#tls_class_tls_tlssocket
|
2018-05-24 13:14:27 +02:00
|
|
|
|
[`tls.checkServerIdentity()`]: tls.html#tls_tls_checkserveridentity_hostname_cert
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`tls.createSecureContext()`]: tls.html#tls_tls_createsecurecontext_options
|
2018-09-05 20:33:20 +02:00
|
|
|
|
[`url.format()`]: url.html#url_url_format_urlobject
|
|
|
|
|
[`url.parse()`]: url.html#url_url_parse_urlstring_parsequerystring_slashesdenotehost
|
|
|
|
|
[`url.resolve()`]: url.html#url_url_resolve_from_to
|
2017-05-08 18:30:13 +02:00
|
|
|
|
[`util._extend()`]: util.html#util_util_extend_target_source
|
2018-10-12 20:11:44 +02:00
|
|
|
|
[`util.getSystemErrorName()`]: util.html#util_util_getsystemerrorname_err
|
2017-09-26 23:14:21 +02:00
|
|
|
|
[`util.inspect()`]: util.html#util_util_inspect_object_options
|
|
|
|
|
[`util.inspect.custom`]: util.html#util_util_inspect_custom
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`util.isArray()`]: util.html#util_util_isarray_object
|
|
|
|
|
[`util.isBoolean()`]: util.html#util_util_isboolean_object
|
|
|
|
|
[`util.isBuffer()`]: util.html#util_util_isbuffer_object
|
|
|
|
|
[`util.isDate()`]: util.html#util_util_isdate_object
|
|
|
|
|
[`util.isError()`]: util.html#util_util_iserror_object
|
|
|
|
|
[`util.isFunction()`]: util.html#util_util_isfunction_object
|
|
|
|
|
[`util.isNull()`]: util.html#util_util_isnull_object
|
|
|
|
|
[`util.isNullOrUndefined()`]: util.html#util_util_isnullorundefined_object
|
|
|
|
|
[`util.isNumber()`]: util.html#util_util_isnumber_object
|
|
|
|
|
[`util.isObject()`]: util.html#util_util_isobject_object
|
|
|
|
|
[`util.isPrimitive()`]: util.html#util_util_isprimitive_object
|
|
|
|
|
[`util.isRegExp()`]: util.html#util_util_isregexp_object
|
|
|
|
|
[`util.isString()`]: util.html#util_util_isstring_object
|
|
|
|
|
[`util.isSymbol()`]: util.html#util_util_issymbol_object
|
|
|
|
|
[`util.isUndefined()`]: util.html#util_util_isundefined_object
|
|
|
|
|
[`util.log()`]: util.html#util_util_log_string
|
2018-01-27 22:01:32 +01:00
|
|
|
|
[`util.types`]: util.html#util_util_types
|
2017-05-08 18:30:13 +02:00
|
|
|
|
[`util`]: util.html
|
2016-12-04 21:47:01 +01:00
|
|
|
|
[`worker.exitedAfterDisconnect`]: cluster.html#cluster_worker_exitedafterdisconnect
|
worker: refactor `worker.terminate()`
At the collaborator summit in Berlin, the behaviour of
`worker.terminate()` was discussed.
In particular, switching from a callback-based to a Promise-based API
was suggested. While investigating that possibility later, it was
discovered that `.terminate()` was unintentionally synchronous up
until now (including calling its callback synchronously).
Also, the topic of its stability has been brought up. I have performed
two manual reviews of the native codebase for compatibility with
`.terminate()`, and performed some manual fuzz testing with the test
suite. At this point, bugs with `.terminate()` should, in my opinion,
be treated like bugs in other Node.js features.
(It is possible to make Node.js crash with `.terminate()` by messing
with internals and/or built-in prototype objects, but that is already
the case without `.terminate()` as well.)
This commit:
- Makes `.terminate()` an asynchronous operation.
- Makes `.terminate()` return a `Promise`.
- Runtime-deprecates passing a callback.
- Removes a warning about its stability from the documentation.
- Eliminates an unnecessary extra function from the C++ code.
A possible alternative to returning a `Promise` would be to keep the
method synchronous and just drop the callback. Generally, providing
an asynchronous API does provide us with a bit more flexibility.
Refs: https://github.com/nodejs/summit/issues/141
PR-URL: https://github.com/nodejs/node/pull/28021
Reviewed-By: Michaël Zasso <targos@protonmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl>
Reviewed-By: Tiancheng "Timothy" Gu <timothygu99@gmail.com>
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
2019-06-02 15:09:57 +02:00
|
|
|
|
[`worker.terminate()`]: worker_threads.html#worker_threads_worker_terminate
|
2018-03-17 16:59:54 +01:00
|
|
|
|
[`zlib.bytesWritten`]: zlib.html#zlib_zlib_byteswritten
|
2018-11-27 20:49:21 +01:00
|
|
|
|
[Legacy URL API]: url.html#url_legacy_url_api
|
|
|
|
|
[NIST SP 800-38D]: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf
|
|
|
|
|
[RFC 6066]: https://tools.ietf.org/html/rfc6066#section-3
|
|
|
|
|
[WHATWG URL API]: url.html#url_the_whatwg_url_api
|
2017-05-08 18:30:13 +02:00
|
|
|
|
[alloc]: buffer.html#buffer_class_method_buffer_alloc_size_fill_encoding
|
|
|
|
|
[alloc_unsafe_size]: buffer.html#buffer_class_method_buffer_allocunsafe_size
|
|
|
|
|
[from_arraybuffer]: buffer.html#buffer_class_method_buffer_from_arraybuffer_byteoffset_length
|
|
|
|
|
[from_string_encoding]: buffer.html#buffer_class_method_buffer_from_string_encoding
|
2018-09-05 20:33:20 +02:00
|
|
|
|
[legacy `urlObject`]: url.html#url_legacy_urlobject
|