Node.js v20.20.6 文档

撤销弃用#>

【Revoking deprecations】

有时，API 的弃用可能会被撤销。在这种情况下，本文件将会更新与该决策相关的信息。然而，弃用标识符将不会被修改。

【Occasionally, the deprecation of an API might be reversed. In such situations, this document will be updated with information relevant to the decision. However, the deprecation identifier will not be modified.】

已弃用的 API 列表#>

【List of deprecated APIs】

DEP0001：http.OutgoingMessage.prototype.flush#>

【DEP0001: http.OutgoingMessage.prototype.flush】

类型：寿命终止

【Type: End-of-Life】

OutgoingMessage.prototype.flush() 已被移除。请改用 OutgoingMessage.prototype.flushHeaders()。

DEP0002: require('_linklist')#>

类型：寿命终止

【Type: End-of-Life】

_linklist 模块已被弃用。请使用用户空间的替代方案。

【The _linklist module is deprecated. Please use a userland alternative.】

DEP0003: _writableState.buffer#>

类型：寿命终止

【Type: End-of-Life】

_writableState.buffer 已被移除。请改用 _writableState.getBuffer()。

【The _writableState.buffer has been removed. Use _writableState.getBuffer() instead.】

DEP0004：CryptoStream.prototype.readyState#>

【DEP0004: CryptoStream.prototype.readyState】

类型：寿命终止

【Type: End-of-Life】

CryptoStream.prototype.readyState 属性已被移除。

【The CryptoStream.prototype.readyState property was removed.】

DEP0005：Buffer() 构造函数#>

【DEP0005: Buffer() constructor】

类型：应用（仅限非 node_modules 代码）

【Type: Application (non-node_modules code only)】

Buffer() 函数和 new Buffer() 构造函数由于 API 可用性问题而被弃用，这些问题可能导致意外的安全问题。

【The Buffer() function and new Buffer() constructor are deprecated due to API usability issues that can lead to accidental security issues.】

作为替代，可以使用以下方法之一来构建 Buffer 对象：

【As an alternative, use one of the following methods of constructing Buffer objects:】

• Buffer.alloc(size[, fill[, encoding]])：创建一个具有 已初始化 内存的 Buffer。
• Buffer.allocUnsafe(size)：创建一个具有 未初始化 内存的 Buffer。
• Buffer.allocUnsafeSlow(size)：创建一个具有 未初始化 内存的 Buffer。
• Buffer.from(array)：创建一个包含 array 副本的 Buffer
• Buffer.from(arrayBuffer[, byteOffset[, length]])：创建一个封装给定 arrayBuffer 的 Buffer。
• Buffer.from(buffer)：创建一个复制 buffer 的 Buffer。
• Buffer.from(string[, encoding])：创建一个复制 string 的 Buffer。

如果没有使用 --pending-deprecation，运行时警告只会针对不在 node_modules 中的代码触发。这意味着使用依赖中的 Buffer() 不会产生弃用警告。使用 --pending-deprecation 后，无论 Buffer() 使用在何处，都会产生运行时警告。

【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.】

DEP0006：child_process options.customFds#>

【DEP0006: child_process options.customFds】

类型：寿命终止

【Type: End-of-Life】

在 child_process 模块的 spawn()、fork() 和 exec() 方法中，options.customFds 选项已被弃用。应改用 options.stdio 选项。

【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.】

DEP0007：将 cluster 中的 worker.suicide 替换为 worker.exitedAfterDisconnect#>

【DEP0007: Replace cluster worker.suicide with worker.exitedAfterDisconnect】

类型：寿命终止

【Type: End-of-Life】

在早期版本的 Node.js cluster 中，Worker 对象上添加了一个名为 suicide 的布尔属性。这个属性的目的是提供关于 Worker 实例如何以及为什么退出的指示。在 Node.js 6.0.0 中，旧属性已被弃用，并被一个新的 worker.exitedAfterDisconnect 属性取代。旧属性名并没有准确描述实际语义，而且带有不必要的情感色彩。

【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 worker.exitedAfterDisconnect property. The old property name did not precisely describe the actual semantics and was unnecessarily emotion-laden.】

DEP0008：require('node:constants')#>

【DEP0008: require('node:constants')】

类型：仅文档

【Type: Documentation-only】

node:constants 模块已被弃用。当需要访问与特定 Node.js 内置模块相关的常量时，开发者应改为参考相关模块公开的 constants 属性。例如，require('node:fs').constants 和 require('node:os').constants。

【The node:constants module is deprecated. When requiring access to constants relevant to specific Node.js builtin modules, developers should instead refer to the constants property exposed by the relevant module. For instance, require('node:fs').constants and require('node:os').constants.】

DEP0009：crypto.pbkdf2 未指定摘要#>

【DEP0009: crypto.pbkdf2 without digest】

类型：寿命终止

【Type: End-of-Life】

在 Node.js 6.0 中，如果未指定摘要就使用 crypto.pbkdf2() API，则被弃用，因为该方法默认使用不推荐的 'SHA1' 摘要。之前会打印弃用警告。从 Node.js 8.0.0 开始，如果调用 crypto.pbkdf2() 或 crypto.pbkdf2Sync() 时将 digest 设置为 undefined，将会抛出 TypeError。

【Use of the crypto.pbkdf2() API without specifying a digest was deprecated in Node.js 6.0 because the method defaulted to using the non-recommended 'SHA1' digest. Previously, a deprecation warning was printed. Starting in Node.js 8.0.0, calling crypto.pbkdf2() or crypto.pbkdf2Sync() with digest set to undefined will throw a TypeError.】

从 Node.js v11.0.0 开始，当 digest 设置为 null 调用这些函数时，会打印弃用警告，以与 digest 为 undefined 时的行为保持一致。

【Beginning in Node.js v11.0.0, calling these functions with digest set to null would print a deprecation warning to align with the behavior when digest is undefined.】

但是，现在传入 undefined 或 null 会抛出 TypeError。

【Now, however, passing either undefined or null will throw a TypeError.】

DEP0010: crypto.createCredentials#>

类型：寿命终止

【Type: End-of-Life】

crypto.createCredentials() API 已被移除。请改用 tls.createSecureContext()。

【The crypto.createCredentials() API was removed. Please use tls.createSecureContext() instead.】

DEP0011：crypto.Credentials#>

【DEP0011: crypto.Credentials】

类型：寿命终止

【Type: End-of-Life】

crypto.Credentials 类已被移除。请改用 tls.SecureContext。

【The crypto.Credentials class was removed. Please use tls.SecureContext instead.】

DEP0012: Domain.dispose#>

类型：寿命终止

【Type: End-of-Life】

Domain.dispose() 已被移除。请通过在域上设置的错误事件处理程序显式地恢复失败的 I/O 操作。

DEP0013：没有回调的 fs 异步函数#>

【DEP0013: fs asynchronous function without callback】

类型：寿命终止

【Type: End-of-Life】

在 Node.js 10.0.0 及以后的版本中，如果调用异步函数而不提供回调函数，会抛出 TypeError。详见 https://github.com/nodejs/node/pull/12562。

DEP0014：fs.read 旧版字符串接口#>

【DEP0014: fs.read legacy String interface】

类型：寿命终止

【Type: End-of-Life】

fs.read() 继承的 String 接口已被弃用。请改用文档中提到的 Buffer API。

【The fs.read() legacy String interface is deprecated. Use the Buffer API as mentioned in the documentation instead.】

DEP0015：fs.readSync 过时的字符串接口#>

【DEP0015: fs.readSync legacy String interface】

类型：寿命终止

【Type: End-of-Life】

fs.readSync() 旧版的 String 接口已被弃用。请改用文档中提到的 Buffer API。

【The fs.readSync() legacy String interface is deprecated. Use the Buffer API as mentioned in the documentation instead.】

DEP0016: GLOBAL/root#>

类型：寿命终止

【Type: End-of-Life】

global 属性的 GLOBAL 和 root 别名在 Node.js 6.0.0 中已被弃用，并已被移除。

【The GLOBAL and root aliases for the global property were deprecated in Node.js 6.0.0 and have since been removed.】

DEP0017: Intl.v8BreakIterator#>

类型：寿命终止

【Type: End-of-Life】

Intl.v8BreakIterator 是一个非标准扩展，已经被移除。 请参阅 Intl.Segmenter。

DEP0018：未处理的 Promise 拒绝#>

【DEP0018: Unhandled promise rejections】

类型：寿命终止

【Type: End-of-Life】

未处理的 Promise 拒绝已被弃用。默认情况下，未处理的 Promise 拒绝会使 Node.js 进程以非零退出码终止。要更改 Node.js 对未处理拒绝的处理方式，请使用 --unhandled-rejections 命令行选项。

【Unhandled promise rejections are deprecated. By default, promise rejections that are not handled terminate the Node.js process with a non-zero exit code. To change the way Node.js treats unhandled rejections, use the --unhandled-rejections command-line option.】

DEP0019：require('.') 在目录外被解析#>

【DEP0019: require('.') resolved outside directory】

类型：寿命终止

【Type: End-of-Life】

在某些情况下，require('.') 可能会解析到包目录之外。此行为已被移除。

【In certain cases, require('.') could resolve outside the package directory. This behavior has been removed.】

DEP0020：Server.connections#>

【DEP0020: Server.connections】

类型：寿命终止

【Type: End-of-Life】

Server.connections 属性在 Node.js v0.9.7 中已被弃用，并且已被移除。请改用 Server.getConnections() 方法。

【The Server.connections property was deprecated in Node.js v0.9.7 and has been removed. Please use the Server.getConnections() method instead.】

DEP0021：Server.listenFD#>

【DEP0021: Server.listenFD】

类型：寿命终止

【Type: End-of-Life】

Server.listenFD() 方法已被弃用并移除。请改用 [Server.listen({fd:<XX1>})][Server.listen({fd:<XX1>})]。

DEP0022: os.tmpDir()#>

类型：寿命终止

【Type: End-of-Life】

os.tmpDir() API 在 Node.js 7.0.0 中已被废弃，并且之后已被移除。请改用 os.tmpdir()。

【The os.tmpDir() API was deprecated in Node.js 7.0.0 and has since been removed. Please use os.tmpdir() instead.】

DEP0023: os.getNetworkInterfaces()#>

类型：寿命终止

【Type: End-of-Life】

os.getNetworkInterfaces() 方法已被弃用。请改用 os.networkInterfaces() 方法。

【The os.getNetworkInterfaces() method is deprecated. Please use the os.networkInterfaces() method instead.】

DEP0024: REPLServer.prototype.convertToContext()#>

类型：寿命终止

【Type: End-of-Life】

REPLServer.prototype.convertToContext() API 已被移除。

【The REPLServer.prototype.convertToContext() API has been removed.】

DEP0025：require('node:sys')#>

【DEP0025: require('node:sys')】

类型：运行时

【Type: Runtime】

node:sys 模块已被弃用。请改用 util 模块。

【The node:sys module is deprecated. Please use the util module instead.】

DEP0026: util.print()#>

类型：寿命终止

【Type: End-of-Life】

util.print() 已被移除。请使用 console.log() 代替。

DEP0027: util.puts()#>

类型：寿命终止

【Type: End-of-Life】

util.puts() 已被移除。请改用 console.log()。

DEP0028: util.debug()#>

类型：寿命终止

【Type: End-of-Life】

util.debug() 已被移除。请使用 console.error() 代替。

DEP0029: util.error()#>

类型：寿命终止

【Type: End-of-Life】

util.error() 已被移除。请使用 console.error() 代替。

DEP0030：SlowBuffer#>

【DEP0030: SlowBuffer】

类型：仅文档

【Type: Documentation-only】

SlowBuffer 类已被弃用。请改用 Buffer.allocUnsafeSlow(size)。

【The SlowBuffer class is deprecated. Please use Buffer.allocUnsafeSlow(size) instead.】

DEP0031: ecdh.setPublicKey()#>

类型：仅文档

【Type: Documentation-only】

ecdh.setPublicKey() 方法现在已被弃用，因为在 API 中包含它没有用处。

【The ecdh.setPublicKey() method is now deprecated as its inclusion in the API is not useful.】

DEP0032: node:domain 模块#>

【DEP0032: node:domain module】

类型：仅文档

【Type: Documentation-only】

domain 模块已弃用，不应使用。

【The domain module is deprecated and should not be used.】

DEP0033: EventEmitter.listenerCount()#>

类型：仅文档

【Type: Documentation-only】

events.listenerCount(emitter, eventName) API 已被弃用。请改用 emitter.listenerCount(eventName)。

【The events.listenerCount(emitter, eventName) API is deprecated. Please use emitter.listenerCount(eventName) instead.】

DEP0034: fs.exists(path, callback)#>

类型：仅文档

【Type: Documentation-only】

fs.exists(path, callback) API 已被弃用。请改用 fs.stat() 或 fs.access()。

【The fs.exists(path, callback) API is deprecated. Please use fs.stat() or fs.access() instead.】

DEP0035：fs.lchmod(路径, 模式, 回调)#>

【DEP0035: fs.lchmod(path, mode, callback)】

类型：仅文档

【Type: Documentation-only】

fs.lchmod(path, mode, callback) API 已被弃用。

【The fs.lchmod(path, mode, callback) API is deprecated.】

DEP0036: fs.lchmodSync(路径, 模式)#>

【DEP0036: fs.lchmodSync(path, mode)】

类型：仅文档

【Type: Documentation-only】

fs.lchmodSync(path, mode) API 已被弃用。

【The fs.lchmodSync(path, mode) API is deprecated.】

DEP0037：fs.lchown(path, uid, gid, callback)#>

【DEP0037: fs.lchown(path, uid, gid, callback)】

类型：弃用已撤销

【Type: Deprecation revoked】

fs.lchown(path, uid, gid, callback) API 已被弃用。由于 libuv 中添加了所需的支持 API，该弃用已被撤销。

【The fs.lchown(path, uid, gid, callback) API was deprecated. The deprecation was revoked because the requisite supporting APIs were added in libuv.】

DEP0038: fs.lchownSync(path, uid, gid)#>

类型：弃用已撤销

【Type: Deprecation revoked】

fs.lchownSync(path, uid, gid) API 已被弃用。由于 libuv 中添加了所需的支持 API，该弃用已被撤销。

【The fs.lchownSync(path, uid, gid) API was deprecated. The deprecation was revoked because the requisite supporting APIs were added in libuv.】

DEP0039: require.extensions#>

类型：仅文档

【Type: Documentation-only】

require.extensions 属性已弃用。

【The require.extensions property is deprecated.】

DEP0040：node:punycode 模块#>

【DEP0040: node:punycode module】

类型：仅文档（支持 --pending-deprecation）

【Type: Documentation-only (supports --pending-deprecation)】

punycode 模块已被弃用。请改用用户空间的替代方案。

【The punycode module is deprecated. Please use a userland alternative instead.】

DEP0041：NODE_REPL_HISTORY_FILE 环境变量#>

【DEP0041: NODE_REPL_HISTORY_FILE environment variable】

类型：寿命终止

【Type: End-of-Life】

NODE_REPL_HISTORY_FILE 环境变量已被移除。请改用 NODE_REPL_HISTORY。

【The NODE_REPL_HISTORY_FILE environment variable was removed. Please use NODE_REPL_HISTORY instead.】

DEP0042: tls.CryptoStream#>

类型：寿命终止

【Type: End-of-Life】

tls.CryptoStream 类已被移除。请改用 tls.TLSSocket。

【The tls.CryptoStream class was removed. Please use tls.TLSSocket instead.】

DEP0043: tls.SecurePair#>

类型：仅文档

【Type: Documentation-only】

tls.SecurePair 类已被弃用。请改用 tls.TLSSocket。

【The tls.SecurePair class is deprecated. Please use tls.TLSSocket instead.】

DEP0044：util.isArray()#>

【DEP0044: util.isArray()】

类型：仅文档

【Type: Documentation-only】

util.isArray() API 已被弃用。请改用 Array.isArray()。

【The util.isArray() API is deprecated. Please use Array.isArray() instead.】

DEP0045：util.isBoolean()#>

【DEP0045: util.isBoolean()】

类型：仅文档

【Type: Documentation-only】

util.isBoolean() API 已被弃用。

【The util.isBoolean() API is deprecated.】

DEP0046: util.isBuffer()#>

类型：仅文档

【Type: Documentation-only】

util.isBuffer() API 已被弃用。请改用 Buffer.isBuffer()。

【The util.isBuffer() API is deprecated. Please use Buffer.isBuffer() instead.】

DEP0047: util.isDate()#>

类型：仅文档

【Type: Documentation-only】

util.isDate() API 已被弃用。

【The util.isDate() API is deprecated.】

DEP0048: util.isError()#>

类型：仅文档

【Type: Documentation-only】

util.isError() API 已被弃用。

【The util.isError() API is deprecated.】

DEP0049: util.isFunction()#>

类型：仅文档

【Type: Documentation-only】

util.isFunction() API 已被弃用。

【The util.isFunction() API is deprecated.】

DEP0050: util.isNull()#>

类型：仅文档

【Type: Documentation-only】

util.isNull() API 已被弃用。

【The util.isNull() API is deprecated.】

DEP0051: util.isNullOrUndefined()#>

类型：仅文档

【Type: Documentation-only】

util.isNullOrUndefined() API 已被弃用。

【The util.isNullOrUndefined() API is deprecated.】

DEP0052: util.isNumber()#>

类型：仅文档

【Type: Documentation-only】

util.isNumber() API 已被弃用。

【The util.isNumber() API is deprecated.】

DEP0053：util.isObject()#>

【DEP0053: util.isObject()】

类型：仅文档

【Type: Documentation-only】

util.isObject() API 已被弃用。

【The util.isObject() API is deprecated.】

DEP0054: util.isPrimitive()#>

类型：仅文档

【Type: Documentation-only】

util.isPrimitive() API 已被弃用。

【The util.isPrimitive() API is deprecated.】

DEP0055: util.isRegExp()#>

类型：仅文档

【Type: Documentation-only】

util.isRegExp() API 已被弃用。

【The util.isRegExp() API is deprecated.】

DEP0056: util.isString()#>

类型：仅文档

【Type: Documentation-only】

util.isString() API 已被弃用。

【The util.isString() API is deprecated.】

DEP0057: util.isSymbol()#>

类型：仅文档

【Type: Documentation-only】

util.isSymbol() API 已被弃用。

【The util.isSymbol() API is deprecated.】

DEP0058：util.isUndefined()#>

【DEP0058: util.isUndefined()】

类型：仅文档

【Type: Documentation-only】

util.isUndefined() API 已被弃用。

【The util.isUndefined() API is deprecated.】

DEP0059: util.log()#>

类型：仅文档

【Type: Documentation-only】

util.log() API 已被弃用。

【The util.log() API is deprecated.】

DEP0060: util._extend()#>

类型：仅文档

【Type: Documentation-only】

util._extend() API 已被弃用。

【The util._extend() API is deprecated.】

DEP0061: fs.SyncWriteStream#>

类型：寿命终止

【Type: End-of-Life】

fs.SyncWriteStream 类从未打算作为公开可访问的 API，并且已被移除。目前没有可用的替代 API。请使用用户空间的替代方案。

【The fs.SyncWriteStream class was never intended to be a publicly accessible API and has been removed. No alternative API is available. Please use a userland alternative.】

DEP0062: node --debug#>

类型：寿命终止

【Type: End-of-Life】

--debug 启用的是已被废弃的 V8 调试器接口，自 V8 5.8 起已被移除。它已被 Inspector 所取代，可通过 --inspect 来启用。

DEP0063: ServerResponse.prototype.writeHeader()#>

类型：仅文档

【Type: Documentation-only】

node:http 模块的 ServerResponse.prototype.writeHeader() API 已被弃用。请改用 ServerResponse.prototype.writeHead()。

【The node:http module ServerResponse.prototype.writeHeader() API is deprecated. Please use ServerResponse.prototype.writeHead() instead.】

ServerResponse.prototype.writeHeader() 方法从未被记录为官方支持的 API。

【The ServerResponse.prototype.writeHeader() method was never documented as an officially supported API.】

DEP0064: tls.createSecurePair()#>

类型：运行时

【Type: Runtime】

在 Node.js 0.11.3 的文档中，tls.createSecurePair() API 已被弃用。用户应改用 tls.Socket。

【The tls.createSecurePair() API was deprecated in documentation in Node.js 0.11.3. Users should use tls.Socket instead.】

DEP0065：repl.REPL_MODE_MAGIC 和 NODE_REPL_MODE=magic#>

【DEP0065: repl.REPL_MODE_MAGIC and NODE_REPL_MODE=magic】

类型：寿命终止

【Type: End-of-Life】

node:repl 模块的 REPL_MODE_MAGIC 常量（用于 replMode 选项）已被移除。自 Node.js 6.0.0 引入 V8 5.0 以来，其行为与 REPL_MODE_SLOPPY 功能上相同。请改用 REPL_MODE_SLOPPY。

【The node:repl module's REPL_MODE_MAGIC constant, used for replMode option, has been removed. Its behavior has been functionally identical to that of REPL_MODE_SLOPPY since Node.js 6.0.0, when V8 5.0 was imported. Please use REPL_MODE_SLOPPY instead.】

NODE_REPL_MODE 环境变量用于设置交互式 node 会话的底层 replMode。其值 magic 也已被移除。请改用 sloppy。

【The NODE_REPL_MODE environment variable is used to set the underlying replMode of an interactive node session. Its value, magic, is also removed. Please use sloppy instead.】

DEP0066：OutgoingMessage.prototype._headers, OutgoingMessage.prototype._headerNames#>

【DEP0066: OutgoingMessage.prototype._headers, OutgoingMessage.prototype._headerNames】

类型：运行时

【Type: Runtime】

node:http 模块的 OutgoingMessage.prototype._headers 和 OutgoingMessage.prototype._headerNames 属性已被弃用。请使用其中一个公共方法（例如 OutgoingMessage.prototype.getHeader()、OutgoingMessage.prototype.getHeaders()、OutgoingMessage.prototype.getHeaderNames()、OutgoingMessage.prototype.getRawHeaderNames()、OutgoingMessage.prototype.hasHeader()、OutgoingMessage.prototype.removeHeader()、OutgoingMessage.prototype.setHeader()）来处理发送的头信息。

【The node: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.getRawHeaderNames(), OutgoingMessage.prototype.hasHeader(), OutgoingMessage.prototype.removeHeader(), OutgoingMessage.prototype.setHeader()) for working with outgoing headers.】

OutgoingMessage.prototype._headers 和 OutgoingMessage.prototype._headerNames 属性从未被记录为官方支持的属性。

【The OutgoingMessage.prototype._headers and OutgoingMessage.prototype._headerNames properties were never documented as officially supported properties.】

DEP0067：OutgoingMessage.prototype._renderHeaders#>

【DEP0067: OutgoingMessage.prototype._renderHeaders】

类型：仅文档

【Type: Documentation-only】

node:http 模块的 OutgoingMessage.prototype._renderHeaders() API 已被弃用。

【The node:http module OutgoingMessage.prototype._renderHeaders() API is deprecated.】

OutgoingMessage.prototype._renderHeaders 属性从未被记录为官方支持的 API。

【The OutgoingMessage.prototype._renderHeaders property was never documented as an officially supported API.】

DEP0068: node debug#>

类型：寿命终止

【Type: End-of-Life】

node debug 对应于旧版命令行调试器，该调试器已被基于 V8 检查器的命令行调试器替代，可通过 node inspect 使用。

DEP0069：vm.runInDebugContext(string)#>

【DEP0069: vm.runInDebugContext(string)】

类型：寿命终止

【Type: End-of-Life】

DebugContext 已在 V8 中删除，在 Node.js 10+ 中不可用。

【DebugContext has been removed in V8 and is not available in Node.js 10+.】

DebugContext 是一个实验性 API。

【DebugContext was an experimental API.】

DEP0070: async_hooks.currentId()#>

类型：寿命终止

【Type: End-of-Life】

async_hooks.currentId() 为了更清晰的表达被重命名为 async_hooks.executionAsyncId()。

此更改是在 async_hooks 作为实验性 API 时进行的。

【This change was made while async_hooks was an experimental API.】

DEP0071: async_hooks.triggerId()#>

类型：寿命终止

【Type: End-of-Life】

async_hooks.triggerId() 为了更清楚的表达被重命名为 async_hooks.triggerAsyncId()。

此更改是在 async_hooks 作为实验性 API 时进行的。

【This change was made while async_hooks was an experimental API.】

DEP0072：async_hooks.AsyncResource.triggerId()#>

【DEP0072: async_hooks.AsyncResource.triggerId()】

类型：寿命终止

【Type: End-of-Life】

async_hooks.AsyncResource.triggerId() 已被重命名为 async_hooks.AsyncResource.triggerAsyncId() 以提高清晰度。

此更改是在 async_hooks 作为实验性 API 时进行的。

【This change was made while async_hooks was an experimental API.】

DEP0073：net.Server 的几个内部属性#>

【DEP0073: Several internal properties of net.Server】

类型：寿命终止

【Type: End-of-Life】

访问 net.Server 实例的多个内部、未文档化属性且使用不当名称已被弃用。

【Accessing several internal, undocumented properties of net.Server instances with inappropriate names is deprecated.】

由于原始 API 没有文档说明，并且对非内部代码通常没有用处，因此没有提供替代 API。

【As the original API was undocumented and not generally useful for non-internal code, no replacement API is provided.】

DEP0074：REPLServer.bufferedCommand#>

【DEP0074: REPLServer.bufferedCommand】

类型：寿命终止

【Type: End-of-Life】

REPLServer.bufferedCommand 属性已被弃用，建议使用 REPLServer.clearBufferedCommand()。

【The REPLServer.bufferedCommand property was deprecated in favor of REPLServer.clearBufferedCommand().】

DEP0075: REPLServer.parseREPLKeyword()#>

类型：寿命终止

【Type: End-of-Life】

REPLServer.parseREPLKeyword() 已从用户可见范围中移除。

DEP0076: tls.parseCertString()#>

类型：寿命终止

【Type: End-of-Life】

tls.parseCertString() 是一个微不足道的解析辅助函数，因为错误而被公开。本应解析证书的主题和颁发者字符串，但它从未正确处理多值相对可分辨名称（RDNs）。

该文档的早期版本建议使用 querystring.parse() 作为 tls.parseCertString() 的替代方法。然而，querystring.parse() 也不能正确处理所有证书主题，因此不应使用。

【Earlier versions of this document suggested using querystring.parse() as an alternative to tls.parseCertString(). However, querystring.parse() also does not handle all certificate subjects correctly and should not be used.】

DEP0077: Module._debug()#>

类型：运行时

【Type: Runtime】

Module._debug() 已被弃用。

Module._debug() 函数从未被记录为官方支持的 API。

【The Module._debug() function was never documented as an officially supported API.】

DEP0078: REPLServer.turnOffEditorMode()#>

类型：寿命终止

【Type: End-of-Life】

REPLServer.turnOffEditorMode() 已从用户可见性中移除。

DEP0079：通过 .inspect() 对对象进行自定义检查函数#>

【DEP0079: Custom inspection function on objects via .inspect()】

类型：寿命终止

【Type: End-of-Life】

在对象上使用名为 inspect 的属性来为 util.inspect() 指定自定义检查函数已被弃用。请改用 util.inspect.custom。为了与 6.4.0 版本之前的 Node.js 向后兼容，可以同时指定两者。

【Using a property named inspect on an object to specify a custom inspection function for util.inspect() is deprecated. Use util.inspect.custom instead. For backward compatibility with Node.js prior to version 6.4.0, both can be specified.】

DEP0080: path._makeLong()#>

类型：仅文档

【Type: Documentation-only】

内部的 path._makeLong() 并非面向公共使用。然而，用户层模块发现它很有用。该内部 API 已被废弃，并由一个相同的公共方法 path.toNamespacedPath() 所取代。

【The internal path._makeLong() was not intended for public use. However, userland modules have found it useful. The internal API is deprecated and replaced with an identical, public path.toNamespacedPath() method.】

DEP0081：使用文件描述符的 fs.truncate()#>

【DEP0081: fs.truncate() using a file descriptor】

类型：运行时

【Type: Runtime】

使用文件描述符的 fs.truncate() 和 fs.truncateSync() 已被弃用。请使用 fs.ftruncate() 或 fs.ftruncateSync() 来处理文件描述符。

DEP0082: REPLServer.prototype.memory()#>

类型：寿命终止

【Type: End-of-Life】

REPLServer.prototype.memory() 仅对 REPLServer 本身的内部机制是必要的。不要使用此函数。

DEP0083：通过将 ecdhCurve 设置为 false 来禁用 ECDH#>

【DEP0083: Disabling ECDH by setting ecdhCurve to false】

类型：已终止服务。

【Type: End-of-Life.】

tls.createSecureContext() 和 tls.TLSSocket 的 ecdhCurve 选项可以设置为 false，以仅在服务器上完全禁用 ECDH。此模式已被弃用，以便为迁移到 OpenSSL 1.1.0 并与客户端保持一致做准备，并且现在已不再支持。请改用 ciphers 参数。

【The ecdhCurve option to tls.createSecureContext() and tls.TLSSocket could be set to false to disable ECDH entirely on the server only. This mode was deprecated in preparation for migrating to OpenSSL 1.1.0 and consistency with the client and is now unsupported. Use the ciphers parameter instead.】

DEP0084：需要打包的内部依赖#>

【DEP0084: requiring bundled internal dependencies】

类型：寿命终止

【Type: End-of-Life】

自 Node.js 版本 4.4.0 和 5.2.0 起，一些仅用于内部的模块被错误地通过 require() 暴露给用户代码。这些模块包括：

【Since Node.js versions 4.4.0 and 5.2.0, several modules only intended for internal usage were mistakenly exposed to user code through require(). These modules were:】

• 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（从 7.6.0 起）
• node-inspect/lib/internal/inspect_client（从 7.6.0 起）
• node-inspect/lib/internal/inspect_repl（从 7.6.0 起）

v8/* 模块没有任何导出，如果不按特定顺序导入，实际上会抛出错误。因此，几乎没有合法的使用场景通过 require() 导入它们。

【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().】

另一方面，node-inspect 可以通过包管理器在本地安装，因为它以相同的名称发布在 npm 注册表上。如果这样做，就不需要修改源代码。

【On the other hand, node-inspect can 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.】

DEP0085：AsyncHooks 敏感 API#>

【DEP0085: AsyncHooks sensitive API】

类型：寿命终止

【Type: End-of-Life】

AsyncHooks 敏感 API 从未被记录，并且存在各种小问题。请使用 AsyncResource API 替代。详见 https://github.com/nodejs/node/issues/15572。

DEP0086：移除 runInAsyncIdScope#>

【DEP0086: Remove runInAsyncIdScope】

类型：寿命终止

【Type: End-of-Life】

runInAsyncIdScope 不会触发 'before' 或 'after' 事件，因此可能会引发许多问题。详见 https://github.com/nodejs/node/issues/14328。

DEP0089：require('node:assert')#>

【DEP0089: require('node:assert')】

类型：弃用已撤销

【Type: Deprecation revoked】

不推荐直接导入 assert，因为暴露的函数使用的是宽松的相等检查。废弃声明已被撤销，因为并不禁止使用 node:assert 模块，而且废弃声明导致了开发者的困惑。

【Importing assert directly was not recommended as the exposed functions use loose equality checks. The deprecation was revoked because use of the node:assert module is not discouraged, and the deprecation caused developer confusion.】

DEP0090：无效的 GCM 认证标签长度#>

【DEP0090: Invalid GCM authentication tag lengths】

类型：寿命终止

【Type: End-of-Life】

Node.js 过去支持所有在调用 decipher.setAuthTag() 时被 OpenSSL 接受的 GCM 认证标签长度。从 Node.js v11.0.0 开始，仅允许 128、120、112、104、96、64 和 32 位的认证标签。其他长度的认证标签根据 NIST SP 800-38D 是无效的。

【Node.js used to support all GCM authentication tag lengths which are accepted by 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.】

DEP0091：crypto.DEFAULT_ENCODING#>

【DEP0091: crypto.DEFAULT_ENCODING】

类型：寿命终止

【Type: End-of-Life】

crypto.DEFAULT_ENCODING 属性仅为与 0.9.3 版本之前的 Node.js 版本兼容而存在，现已被移除。

【The crypto.DEFAULT_ENCODING property only existed for compatibility with Node.js releases prior to versions 0.9.3 and has been removed.】

DEP0092：顶层 this 绑定到 module.exports#>

【DEP0092: Top-level this bound to module.exports】

类型：仅文档

【Type: Documentation-only】

将属性分配给顶层 this 作为 module.exports 的替代方法已被弃用。开发者应使用 exports 或 module.exports。

【Assigning properties to the top-level this as an alternative to module.exports is deprecated. Developers should use exports or module.exports instead.】

DEP0093：crypto.fips 已被弃用并被替代#>

【DEP0093: crypto.fips is deprecated and replaced】

类型：仅文档

【Type: Documentation-only】

crypto.fips 属性已弃用。请改用 crypto.setFips() 和 crypto.getFips()。

【The crypto.fips property is deprecated. Please use crypto.setFips() and crypto.getFips() instead.】

DEP0094：使用 assert.fail() 时传入多个参数#>

【DEP0094: Using assert.fail() with more than one argument】

类型：运行时

【Type: Runtime】

使用带有多个参数的 assert.fail() 已被弃用。请使用仅带一个参数的 assert.fail() 或使用其他 node:assert 模块方法。

【Using assert.fail() with more than one argument is deprecated. Use assert.fail() with only one argument or use a different node:assert module method.】

DEP0095: timers.enroll()#>

类型：运行时

【Type: Runtime】

timers.enroll() 已被弃用。请改用公开文档中介绍的 setTimeout() 或 setInterval()。

DEP0096: timers.unenroll()#>

类型：运行时

【Type: Runtime】

timers.unenroll() 已弃用。请改用公开文档中介绍的 clearTimeout() 或 clearInterval()。

DEP0097：带有 domain 属性的 MakeCallback#>

【DEP0097: MakeCallback with domain property】

类型：运行时

【Type: Runtime】

使用 MakeCallback 并添加 domain 属性以携带上下文的用户，应开始使用 MakeCallback 的 async_context 版本或 CallbackScope，或者使用高级的 AsyncResource 类。

【Users of MakeCallback that add the domain property to carry context, should start using the async_context variant of MakeCallback or CallbackScope, or the high-level AsyncResource class.】

DEP0098：AsyncHooks 嵌入器 AsyncResource.emitBefore 和 AsyncResource.emitAfter API#>

【DEP0098: AsyncHooks embedder AsyncResource.emitBefore and AsyncResource.emitAfter APIs】

类型：寿命终止

【Type: End-of-Life】

AsyncHooks 提供的嵌入式 API 暴露了 .emitBefore() 和 .emitAfter() 方法，这些方法很容易被错误使用，可能导致无法恢复的错误。

【The embedded API provided by AsyncHooks exposes .emitBefore() and .emitAfter() methods which are very easy to use incorrectly which can lead to unrecoverable errors.】

请改用 asyncResource.runInAsyncScope() API，它提供了更安全、更方便的替代方案。详见 https://github.com/nodejs/node/pull/18513。

DEP0099：异步上下文不感知的 node::MakeCallback C++ API#>

【DEP0099: Async context-unaware node::MakeCallback C++ APIs】

类型：编译时

【Type: Compile-time】

某些提供给本地插件的 node::MakeCallback API 版本已被弃用。请使用接受 async_context 参数的 API 版本。

【Certain versions of node::MakeCallback APIs available to native addons are deprecated. Please use the versions of the API that accept an async_context parameter.】

DEP0100: process.assert()#>

类型：运行时

【Type: Runtime】

process.assert() 已被弃用。请改用 assert 模块。

这从来都不是记录在案的功能。

【This was never a documented feature.】

DEP0101: --with-lttng#>

类型：寿命终止

【Type: End-of-Life】

--with-lttng 编译时选项已被移除。

【The --with-lttng compile-time option has been removed.】

DEP0102：在 Buffer#(read|write) 操作中使用 noAssert#>

【DEP0102: Using noAssert in Buffer#(read|write) operations】

类型：寿命终止

【Type: End-of-Life】

使用 noAssert 参数现在已经没有任何功能了。无论 noAssert 的值如何，所有输入都会被验证。跳过验证可能会导致难以发现的错误和崩溃。

【Using the noAssert argument has no functionality anymore. All input is verified regardless of the value of noAssert. Skipping the verification could lead to hard-to-find errors and crashes.】

DEP0103：process.binding('util').is[...] 类型检查#>

【DEP0103: process.binding('util').is[...] typechecks】

类型：仅文档（支持 --pending-deprecation）

【Type: Documentation-only (supports --pending-deprecation)】

一般应避免使用 process.binding()。特别是类型检查方法，可以使用 util.types 来替代。

【Using process.binding() in general should be avoided. The type checking methods in particular can be replaced by using util.types.】

此弃用已被 process.binding() API 的弃用所取代 (DEP0111)。

【This deprecation has been superseded by the deprecation of the process.binding() API (DEP0111).】

DEP0104：process.env 字符串强制转换#>

【DEP0104: process.env string coercion】

类型：仅文档（支持 --pending-deprecation）

【Type: Documentation-only (supports --pending-deprecation)】

当将非字符串属性赋值给 process.env 时，赋的值会被隐式转换为字符串。如果赋值的不是字符串、布尔值或数字，这种行为已被弃用。将来，此类赋值可能会导致抛出错误。请在将属性赋值给 process.env 之前先将其转换为字符串。

【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 might result in a thrown error. Please convert the property to a string before assigning it to process.env.】

DEP0105: decipher.finaltol#>

类型：寿命终止

【Type: End-of-Life】

decipher.finaltol() 从未有过文档记录，并且曾是 decipher.final() 的别名。该 API 已被移除，建议改用 decipher.final()。

DEP0106: crypto.createCipher 和 crypto.createDecipher#>

【DEP0106: crypto.createCipher and crypto.createDecipher】

类型：运行时

【Type: Runtime】

必须避免使用 crypto.createCipher() 和 crypto.createDecipher()，因为它们使用弱密钥派生函数（无盐的 MD5）和静态初始化向量。建议使用 crypto.pbkdf2() 或 crypto.scrypt() 结合随机盐生成密钥，并使用 crypto.createCipheriv() 和 crypto.createDecipheriv() 分别获取 Cipher 和 Decipher 对象。

【Using crypto.createCipher() and crypto.createDecipher() must 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 crypto.pbkdf2() or crypto.scrypt() with random salts and to use crypto.createCipheriv() and crypto.createDecipheriv() to obtain the Cipher and Decipher objects respectively.】

DEP0107: tls.convertNPNProtocols()#>

类型：寿命终止

【Type: End-of-Life】

这是一个未记录的辅助函数，原本不打算在 Node.js 核心之外使用，并且由于 NPN（下一协议协商）支持的移除而被弃用。

【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.】

DEP0108: zlib.bytesRead#>

类型：运行时

【Type: Runtime】

zlib.bytesWritten 的已弃用别名。这个原始名称之所以被选择，是因为将该值解释为引擎读取的字节数也有意义，但它与 Node.js 中其他以这些名称公开值的流不一致。

【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.】

DEP0109：对无效 URL 的 http、https 和 tls 支持#>

【DEP0109: http, https, and tls support for invalid URLs】

类型：寿命终止

【Type: End-of-Life】

以前一些曾被支持过（但严格来说无效的）URL 可以通过 http.request()、http.get()、https.request()、https.get() 和 tls.checkServerIdentity() API 被接受，这是因为这些 URL 在旧版的 url.parse() API 中是被接受的。上述 API 现在使用要求严格有效 URL 的 WHATWG URL 解析器。传递无效 URL 已被弃用，未来将取消支持。

【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.】

DEP0110：vm.Script 缓存数据#>

【DEP0110: vm.Script cached data】

类型：仅文档

【Type: Documentation-only】

produceCachedData 选项已被弃用。请改用 script.createCachedData()。

【The produceCachedData option is deprecated. Use script.createCachedData() instead.】

DEP0111: process.binding()#>

类型：仅文档（支持 --pending-deprecation）

【Type: Documentation-only (supports --pending-deprecation)】

process.binding() 仅供 Node.js 内部代码使用。

虽然 process.binding() 并未完全停止支持，但当启用 政策 或 权限模型 时，它无法使用。

【While process.binding() has not reached End-of-Life status in general, it is unavailable when policies or the permission model are enabled.】

DEP0112: dgram 私有 API#>

【DEP0112: dgram private APIs】

类型：运行时

【Type: Runtime】

node:dgram 模块以前包含一些从未打算在 Node.js 核心之外访问的 API：Socket.prototype._handle、Socket.prototype._receiving、Socket.prototype._bindState、Socket.prototype._queue、Socket.prototype._reuseAddr、Socket.prototype._healthCheck()、Socket.prototype._stopReceiving() 和 dgram._createSocketHandle()。

【The node: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().】

DEP0113：Cipher.setAuthTag()，Decipher.getAuthTag()#>

【DEP0113: Cipher.setAuthTag(), Decipher.getAuthTag()】

类型：寿命终止

【Type: End-of-Life】

Cipher.setAuthTag() 和 Decipher.getAuthTag() 不再可用。它们从未被记录过，并且在调用时会抛出异常。

DEP0114: crypto._toBuf()#>

类型：寿命终止

【Type: End-of-Life】

crypto._toBuf() 函数并不是为 Node.js 核心之外的模块设计的，并且已经被删除。

【The crypto._toBuf() function was not designed to be used by modules outside of Node.js core and was removed.】

DEP0115：crypto.prng()、crypto.pseudoRandomBytes()、crypto.rng()#>

【DEP0115: crypto.prng(), crypto.pseudoRandomBytes(), crypto.rng()】

类型：仅文档（支持 --pending-deprecation）

【Type: Documentation-only (supports --pending-deprecation)】

在最近版本的 Node.js 中，crypto.randomBytes() 与 crypto.pseudoRandomBytes() 没有区别。后者已被弃用，同时未记录的别名 crypto.prng() 和 crypto.rng() 也不推荐使用，建议使用 crypto.randomBytes()，并且在将来的版本中可能会被移除。

【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 crypto.rng() in favor of crypto.randomBytes() and might be removed in a future release.】

DEP0116：旧版 URL API#>

【DEP0116: Legacy URL API】

类型：弃用已撤销

【Type: Deprecation revoked】

旧版 URL API 已被弃用。这包括 url.format()、url.parse()、url.resolve() 和 遗留 urlObject。请改用 WHATWG URL API。

【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.】

DEP0117：本地加密处理器#>

【DEP0117: Native crypto handles】

类型：寿命终止

【Type: End-of-Life】

Node.js 的早期版本通过 Cipher、Decipher、DiffieHellman、DiffieHellmanGroup、ECDH、Hash、Hmac、Sign 和 Verify 类的 _handle 属性暴露了内部原生对象的句柄。由于不当使用原生对象可能导致应用崩溃，因此已移除了 _handle 属性。

【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. The _handle property has been removed because improper use of the native object can lead to crashing the application.】

DEP0118：dns.lookup() 对假值主机名的支持#>

【DEP0118: dns.lookup() support for a falsy host name】

类型：运行时

【Type: Runtime】

Node.js 的早期版本由于向后兼容性，支持使用假值主机名调用 dns.lookup()，例如 dns.lookup(false)。 这种行为没有文档说明，并且在实际应用中据认为几乎没有使用。 在未来的 Node.js 版本中，这将成为一个错误。

【Previous versions of Node.js supported dns.lookup() with a falsy host name 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.】

DEP0119：process.binding('uv').errname() 私有 API#>

【DEP0119: process.binding('uv').errname() private API】

类型：仅文档（支持 --pending-deprecation）

【Type: Documentation-only (supports --pending-deprecation)】

process.binding('uv').errname() 已被弃用。请改用 util.getSystemErrorName()。

DEP0120：Windows 性能计数器支持#>

【DEP0120: Windows Performance Counter support】

类型：寿命终止

【Type: End-of-Life】

Windows 性能计数器支持已从 Node.js 中移除。未记录的 COUNTER_NET_SERVER_CONNECTION()、COUNTER_NET_SERVER_CONNECTION_CLOSE()、COUNTER_HTTP_SERVER_REQUEST()、COUNTER_HTTP_SERVER_RESPONSE()、COUNTER_HTTP_CLIENT_REQUEST() 和 COUNTER_HTTP_CLIENT_RESPONSE() 函数已被弃用。

【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.】

DEP0121：net._setSimultaneousAccepts()#>

【DEP0121: net._setSimultaneousAccepts()】

类型：运行时

【Type: Runtime】

未记录的 net._setSimultaneousAccepts() 函数最初是用于在 Windows 上使用 node:child_process 和 node:cluster 模块时进行调试和性能调优。该函数通常没有实际用途，现已被移除。讨论请见此处： https://github.com/nodejs/node/issues/18391

DEP0122: tls Server.prototype.setOptions()#>

类型：运行时

【Type: Runtime】

请改用 Server.prototype.setSecureContext()。

【Please use Server.prototype.setSecureContext() instead.】

DEP0123：将 TLS ServerName 设置为 IP 地址#>

【DEP0123: setting the TLS ServerName to an IP address】

类型：运行时

【Type: Runtime】

将 TLS ServerName 设置为 IP 地址是不被 RFC 6066 允许的。在未来的版本中，这将被忽略。

【Setting the TLS ServerName to an IP address is not permitted by RFC 6066. This will be ignored in a future version.】

DEP0124：使用 REPLServer.rli#>

【DEP0124: using REPLServer.rli】

类型：寿命终止

【Type: End-of-Life】

此属性是对实例本身的引用。

【This property is a reference to the instance itself.】

DEP0125: require('node:_stream_wrap')#>

类型：运行时

【Type: Runtime】

node:_stream_wrap 模块已被弃用。

【The node:_stream_wrap module is deprecated.】

DEP0126: timers.active()#>

类型：运行时

【Type: Runtime】

以前未记录的 timers.active() 已被弃用。请改用公开文档中的 timeout.refresh()。如果需要重新引用超时，可以使用 timeout.ref()，自 Node.js 10 起不会影响性能。

【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.】

DEP0127：timers._unrefActive()#>

【DEP0127: timers._unrefActive()】

类型：运行时

【Type: Runtime】

先前未记录且“私有”的 timers._unrefActive() 已被弃用。请改用公开记录的 timeout.refresh()。如果需要取消引用超时，可以使用 timeout.unref()，自 Node.js 10 起不会影响性能。

【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.】

DEP0128：具有无效 main 条目且包含 index.js 文件的模块#>

【DEP0128: modules with an invalid main entry and an index.js file】

类型：运行时

【Type: Runtime】

具有无效 main 条目（例如 ./does-not-exist.js）并且在顶层目录中还有 index.js 文件的模块，将会解析 index.js 文件。这种做法已被弃用，并将在未来的 Node.js 版本中抛出错误。

【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.】

DEP0129: ChildProcess._channel#>

类型：运行时

【Type: Runtime】

由 spawn() 和类似函数返回的子进程对象的 _channel 属性不适合公开使用。请改用 ChildProcess.channel。

【The _channel property of child process objects returned by spawn() and similar functions is not intended for public use. Use ChildProcess.channel instead.】

DEP0130: Module.createRequireFromPath()#>

类型：寿命终止

【Type: End-of-Life】

改用module.createRequire()。

【Use module.createRequire() instead.】

DEP0131：旧版 HTTP 解析器#>

【DEP0131: Legacy HTTP parser】

类型：寿命终止

【Type: End-of-Life】

在 Node.js 12.0.0 之前的版本中默认使用的传统 HTTP 解析器已被弃用，并在 v13.0.0 中移除。在 v13.0.0 之前，可以使用 --http-parser=legacy 命令行标志回退到使用传统解析器。

【The legacy HTTP parser, used by default in versions of Node.js prior to 12.0.0, is deprecated and has been removed in v13.0.0. Prior to v13.0.0, the --http-parser=legacy command-line flag could be used to revert to using the legacy parser.】

DEP0132：带回调的 worker.terminate()#>

【DEP0132: worker.terminate() with callback】

类型：运行时

【Type: Runtime】

向 worker.terminate() 传递回调已被弃用。请改用返回的 Promise，或使用 worker 的 'exit' 事件监听器。

【Passing a callback to worker.terminate() is deprecated. Use the returned Promise instead, or a listener to the worker's 'exit' event.】

DEP0133：http 连接#>

【DEP0133: http connection】

类型：仅文档

【Type: Documentation-only】

偏好 response.socket 而不是 response.connection，以及偏好 request.socket 而不是 request.connection。

【Prefer response.socket over response.connection and request.socket over request.connection.】

DEP0134: process._tickCallback#>

类型：仅文档（支持 --pending-deprecation）

【Type: Documentation-only (supports --pending-deprecation)】

process._tickCallback 属性从未被记录为官方支持的 API。

【The process._tickCallback property was never documented as an officially supported API.】

DEP0135：WriteStream.open() 和 ReadStream.open() 是内部的#>

【DEP0135: WriteStream.open() and ReadStream.open() are internal】

类型：运行时

【Type: Runtime】

WriteStream.open() 和 ReadStream.open() 是未记录的内部 API，在用户空间中使用没有意义。文件流应始终通过其对应的工厂方法 fs.createWriteStream() 和 fs.createReadStream() 打开，或者在选项中传入文件描述符。

DEP0136: http 已完成#>

【DEP0136: http finished】

类型：仅文档

【Type: Documentation-only】

response.finished 表示 response.end() 是否已被调用，而不是表示 'finish' 是否已被触发以及底层数据是否已刷新。

相应地使用 response.writableFinished 或 response.writableEnded，以避免产生歧义。

【Use response.writableFinished or response.writableEnded accordingly instead to avoid the ambiguity.】

为了保持现有行为，应将 response.finished 替换为 response.writableEnded。

【To maintain existing behavior response.finished should be replaced with response.writableEnded.】

DEP0137：在垃圾回收时关闭 fs.FileHandle#>

【DEP0137: Closing fs.FileHandle on garbage collection】

类型：运行时

【Type: Runtime】

允许在垃圾回收时关闭 fs.FileHandle 对象已被弃用。将来，这样做可能会导致抛出错误并终止进程。

【Allowing a fs.FileHandle object to be closed on garbage collection is deprecated. In the future, doing so might result in a thrown error that will terminate the process.】

请确保在不再需要 fs.FileHandle 时，使用 FileHandle.prototype.close() 显式关闭所有 fs.FileHandle 对象：

【Please ensure that all fs.FileHandle objects are explicitly closed using FileHandle.prototype.close() when the fs.FileHandle is no longer needed:】

const fsPromises = require('node:fs').promises;
async function openAndClose() {
  let filehandle;
  try {
    filehandle = await fsPromises.open('thefile.txt', 'r');
  } finally {
    if (filehandle !== undefined)
      await filehandle.close();
  }
} 拷贝

DEP0138: process.mainModule#>

类型：仅文档

【Type: Documentation-only】

process.mainModule 是仅限 CommonJS 的功能，而 process 全局对象可以在非 CommonJS 环境中共享。在 ECMAScript 模块中使用它是不支持的。

它已被弃用，建议使用 require.main，因为它具有相同的功能，并且仅在 CommonJS 环境中可用。

【It is deprecated in favor of require.main, because it serves the same purpose and is only available on CommonJS environment.】

DEP0139：process.umask() 没有参数#>

【DEP0139: process.umask() with no arguments】

类型：仅文档

【Type: Documentation-only】

调用不带参数的 process.umask() 会导致全局 umask 被写入两次。这会在线程之间引入竞争条件，并且可能成为安全漏洞。没有安全的跨平台替代 API。

【Calling process.umask() with no argument causes the process-wide umask to be written twice. This introduces a race condition between threads, and is a potential security vulnerability. There is no safe, cross-platform alternative API.】

DEP0140：使用 request.destroy() 替代 request.abort()#>

【DEP0140: Use request.destroy() instead of request.abort()】

类型：仅文档

【Type: Documentation-only】

使用 request.destroy() 替代 request.abort()。

【Use request.destroy() instead of request.abort().】

DEP0141：repl.inputStream 和 repl.outputStream#>

【DEP0141: repl.inputStream and repl.outputStream】

类型：仅文档（支持 --pending-deprecation）

【Type: Documentation-only (supports --pending-deprecation)】

node:repl 模块导出了两次输入和输出流。请使用 .input 替代 .inputStream，使用 .output 替代 .outputStream。

【The node:repl module exported the input and output stream twice. Use .input instead of .inputStream and .output instead of .outputStream.】

DEP0142：repl._builtinLibs#>

【DEP0142: repl._builtinLibs】

类型：仅文档

【Type: Documentation-only】

node:repl 模块导出了一个 _builtinLibs 属性，其中包含一个内置模块的数组。到目前为止它还不完整，因此更好的是依赖 require('node:module').builtinModules。

【The node:repl module exports a _builtinLibs property that contains an array of built-in modules. It was incomplete so far and instead it's better to rely upon require('node:module').builtinModules.】

DEP0143: Transform._transformState#>

类型：运行时 Transform._transformState将在将来的版本中被移除，因为随着实现的简化，它将不再需要。

【Type: Runtime Transform._transformState will be removed in future versions where it is no longer required due to simplification of the implementation.】

DEP0144: module.parent#>

类型：仅文档（支持 --pending-deprecation）

【Type: Documentation-only (supports --pending-deprecation)】

CommonJS 模块可以通过 module.parent 访问第一个导入它的模块。由于在存在 ECMAScript 模块时此功能无法一致工作，并且它会对 CommonJS 模块图提供不准确的表示，因此该功能已被弃用。

【A CommonJS module can access the first module that required it using module.parent. This feature is deprecated because it does not work consistently in the presence of ECMAScript modules and because it gives an inaccurate representation of the CommonJS module graph.】

一些模块使用它来检查它们是否是当前进程的入口点。相反，建议比较 require.main 和 module：

【Some modules use it to check if they are the entry point of the current process. Instead, it is recommended to compare require.main and module:】

if (require.main === module) {
  // Code section that will run only if current file is the entry point.
} 拷贝

在查找已经引用当前模块的 CommonJS 模块时，可以使用 require.cache 和 module.children：

【When looking for the CommonJS modules that have required the current one, require.cache and module.children can be used:】

const moduleParents = Object.values(require.cache)
  .filter((m) => m.children.includes(module)); 拷贝

DEP0145: socket.bufferSize#>

类型：仅文档

【Type: Documentation-only】

socket.bufferSize只是writable.writableLength的别名。

DEP0146: new crypto.Certificate()#>

类型：仅文档

【Type: Documentation-only】

crypto.Certificate() 构造函数 已不推荐使用。请改用 crypto.Certificate() 的静态方法。

【The crypto.Certificate() constructor is deprecated. Use static methods of crypto.Certificate() instead.】

DEP0147: fs.rmdir(path, { recursive: true })#>

类型：运行时

【Type: Runtime】

在未来版本的 Node.js 中，fs.rmdir、fs.rmdirSync 和 fs.promises.rmdir 的 recursive 选项将被忽略。

【In future versions of Node.js, recursive option will be ignored for fs.rmdir, fs.rmdirSync, and fs.promises.rmdir.】

请使用 fs.rm(path, { recursive: true, force: true })、fs.rmSync(path, { recursive: true, force: true }) 或 fs.promises.rm(path, { recursive: true, force: true })。

【Use fs.rm(path, { recursive: true, force: true }), fs.rmSync(path, { recursive: true, force: true }) or fs.promises.rm(path, { recursive: true, force: true }) instead.】

DEP0148：'“exports”中的文件夹映射（后尾是“/”'）#>

【DEP0148: Folder mappings in "exports" (trailing "/")】

类型：寿命终止

【Type: End-of-Life】

在 子路径导出 或 子路径导入 字段中使用结尾的“/”来定义子路径文件夹映射已不再受支持。请改用 子路径模式。

【Using a trailing "/" to define subpath folder mappings in the subpath exports or subpath imports fields is no longer supported. Use subpath patterns instead.】

DEP0149：http.IncomingMessage#connection#>

【DEP0149: http.IncomingMessage#connection】

类型：仅文档。

【Type: Documentation-only.】

更喜欢 message.socket 而不是 message.connection。

【Prefer message.socket over message.connection.】

DEP0150：更改 process.config 的值#>

【DEP0150: Changing the value of process.config】

类型：寿命终止

【Type: End-of-Life】

process.config 属性提供对 Node.js 编译时设置的访问。然而，该属性是可变的，因此可能被篡改。将来版本的 Node.js 中将移除修改其值的能力。

【The process.config property provides access to Node.js compile-time settings. However, the property is mutable and therefore subject to tampering. The ability to change the value will be removed in a future version of Node.js.】

DEP0151：主索引查找和扩展搜索#>

【DEP0151: Main index lookup and extension searching】

类型：运行时

【Type: Runtime】

以前，index.js 和扩展名搜索查找会应用于 import 'pkg' 的主入口点解析，即使是在解析 ES 模块时也是如此。

【Previously, index.js and extension searching lookups would apply to import 'pkg' main entry point resolution, even when resolving ES modules.】

随着此弃用，所有 ES 模块主入口点解析都需要使用带有确切文件扩展名的显式 "exports" 或 "main" 入口。

【With this deprecation, all ES module main entry point resolutions require an explicit "exports" or "main" entry with the exact file extension.】

DEP0152：扩展 PerformanceEntry 属性#>

【DEP0152: Extension PerformanceEntry properties】

类型：运行时

【Type: Runtime】

'gc'、'http2' 和 'http' <PerformanceEntry> 对象类型被分配了额外的属性，这些属性提供了额外的信息。这些属性现在可以通过 PerformanceEntry 对象的标准 detail 属性获取。现有的访问器已被弃用，不应再使用。

【The 'gc', 'http2', and 'http' <PerformanceEntry> object types have additional properties assigned to them that provide additional information. These properties are now available within the standard detail property of the PerformanceEntry object. The existing accessors have been deprecated and should no longer be used.】

DEP0153：dns.lookup 和 dnsPromises.lookup 选项类型强制转换#>

【DEP0153: dns.lookup and dnsPromises.lookup options type coercion】

类型：寿命终止

【Type: End-of-Life】

在 dns.lookup() 和 dnsPromises.lookup() 中，family 选项使用非 null 且非整数的值，hints 选项使用非 null 且非数字的值，all 选项使用非 null 且非布尔值的值，或者 verbatim 选项使用非 null 且非布尔值的值，会抛出 ERR_INVALID_ARG_TYPE 错误。

【Using a non-nullish non-integer value for family option, a non-nullish non-number value for hints option, a non-nullish non-boolean value for all option, or a non-nullish non-boolean value for verbatim option in dns.lookup() and dnsPromises.lookup() throws an ERR_INVALID_ARG_TYPE error.】

DEP0154：RSA-PSS 生成密钥对选项#>

【DEP0154: RSA-PSS generate key pair options】

类型：运行时

【Type: Runtime】

'hash' 和 'mgf1Hash' 选项已被 'hashAlgorithm' 和 'mgf1HashAlgorithm' 取代。

【The 'hash' and 'mgf1Hash' options are replaced with 'hashAlgorithm' and 'mgf1HashAlgorithm'.】

DEP0155：模式说明符解析中的尾随斜杠#>

【DEP0155: Trailing slashes in pattern specifier resolutions】

类型：运行时

【Type: Runtime】

像“import 'pkg/x/''”这类以“/”结尾的指定词重新映射被淘汰了 用于包的“导出”和“导入”模式分辨率。

【The remapping of specifiers ending in "/" like import 'pkg/x/' is deprecated for package "exports" and "imports" pattern resolutions.】

DEP0156：http 中的 .aborted 属性以及 'abort'、'aborted' 事件#>

【DEP0156: .aborted property and 'abort', 'aborted' event in http】

类型：仅文档

【Type: Documentation-only】

改为使用 <Stream> API，因为 http.ClientRequest、http.ServerResponse 和 http.IncomingMessage 都是基于流的。请检查 stream.destroyed 而不是 .aborted 属性，并监听 'close' 事件，而不是 'abort' 或 'aborted' 事件。

【Move to <Stream> API instead, as the http.ClientRequest, http.ServerResponse, and http.IncomingMessage are all stream-based. Check stream.destroyed instead of the .aborted property, and listen for 'close' instead of 'abort', 'aborted' event.】

.aborted 属性和 'abort' 事件仅用于检测 .abort() 调用。要提前关闭请求，请使用 Stream 的 .destroy([error])，然后检查 .destroyed 属性，'close' 事件应该会有相同的效果。接收端还应检查 http.IncomingMessage 上的 readable.readableEnded 值，以确定是被中止还是正常销毁。

【The .aborted property and 'abort' event are only useful for detecting .abort() calls. For closing a request early, use the Stream .destroy([error]) then check the .destroyed property and 'close' event should have the same effect. The receiving end should also check the readable.readableEnded value on http.IncomingMessage to get whether it was an aborted or graceful destroy.】

DEP0157：流中的可 then 对象支持#>

【DEP0157: Thenable support in streams】

类型：寿命终止

【Type: End-of-Life】

Node.js 流的一个未记录功能是支持在实现方法中使用 thenable。这现已被弃用，请改用回调，并避免在流的实现方法中使用异步函数。

【An undocumented feature of Node.js streams was to support thenables in implementation methods. This is now deprecated, use callbacks instead and avoid use of async function for streams implementation methods.】

此功能导致用户遇到意外问题，例如用户以回调方式实现函数，但使用了异步方法，这会导致错误，因为混合使用 Promise 和回调语义是无效的。

【This feature caused users to encounter unexpected problems where the user implements the function in callback style but uses e.g. an async method which would cause an error since mixing promise and callback semantics is not valid.】

const w = new Writable({
  async final(callback) {
    await someOp();
    callback();
  },
}); 拷贝

DEP0158: buffer.slice(start, end)#>

类型：仅文档

【Type: Documentation-only】

此方法已被弃用，因为它与 Uint8Array.prototype.slice() 不兼容，而 Uint8Array.prototype.slice() 是 Buffer 的超类。

【This method was deprecated because it is not compatible with Uint8Array.prototype.slice(), which is a superclass of Buffer.】

改用功能相同的buffer.subarray。

【Use buffer.subarray which does the same thing instead.】

DEP0159: ERR_INVALID_CALLBACK#>

类型：寿命终止

【Type: End-of-Life】

由于增加了对值类型验证错误的混淆，此错误代码已被移除。

【This error code was removed due to adding more confusion to the errors used for value type validation.】

DEP0160：process.on('multipleResolves', handler)#>

【DEP0160: process.on('multipleResolves', handler)】

类型：运行时。

【Type: Runtime.】

这个事件已被弃用，因为它无法与 V8 的 promise 组合器一起使用，导致其实用性降低。

【This event was deprecated because it did not work with V8 promise combinators which diminished its usefulness.】

DEP0161：process._getActiveRequests() 和 process._getActiveHandles()#>

【DEP0161: process._getActiveRequests() and process._getActiveHandles()】

类型：仅文档

【Type: Documentation-only】

process._getActiveHandles() 和 process._getActiveRequests() 函数不适合公开使用，未来版本可能会被移除。

【The process._getActiveHandles() and process._getActiveRequests() functions are not intended for public use and can be removed in future releases.】

使用 process.getActiveResourcesInfo() 获取活动资源类型的列表，而不是实际引用。

【Use process.getActiveResourcesInfo() to get a list of types of active resources and not the actual references.】

DEP0162：fs.write()、fs.writeFileSync() 强制转换为字符串#>

【DEP0162: fs.write(), fs.writeFileSync() coercion to string】

类型：寿命终止

【Type: End-of-Life】

将具有自身 toString 属性的对象作为 fs.write()、fs.writeFile()、fs.appendFile()、fs.writeFileSync() 和 fs.appendFileSync() 的第二个参数隐式强制转换已被弃用。请将它们转换为原始字符串。

【Implicit coercion of objects with own toString property, passed as second parameter in fs.write(), fs.writeFile(), fs.appendFile(), fs.writeFileSync(), and fs.appendFileSync() is deprecated. Convert them to primitive strings.】

DEP0163：channel.subscribe(onMessage)，channel.unsubscribe(onMessage)#>

【DEP0163: channel.subscribe(onMessage), channel.unsubscribe(onMessage)】

类型：仅文档

【Type: Documentation-only】

这些方法已被弃用，因为它们可能被用于一种不能保持通道引用足够长时间以接收事件的方式。

【These methods were deprecated because they can be used in a way which does not hold the channel reference alive long enough to receive the events.】

改用 diagnostics_channel.subscribe(name, onMessage) 或 diagnostics_channel.unsubscribe(name, onMessage)，它们做的事情一样。

【Use diagnostics_channel.subscribe(name, onMessage) or diagnostics_channel.unsubscribe(name, onMessage) which does the same thing instead.】

DEP0164：process.exit(code)、process.exitCode 强制转换为整数#>

【DEP0164: process.exit(code), process.exitCode coercion to integer】

类型：寿命终止

【Type: End-of-Life】

除 undefined、null、整数和整数字符串（例如 '1'）之外的值，作为 process.exit() 中 code 参数的值以及作为赋值给 process.exitCode 的值，已被弃用。

【Values other than undefined, null, integer numbers, and integer strings (e.g., '1') are deprecated as value for the code parameter in process.exit() and as value to assign to process.exitCode.】

DEP0165: --trace-atomics-wait#>

类型：仅文档

【Type: Documentation-only】

--trace-atomics-wait 标志已被淘汰。

【The --trace-atomics-wait flag is deprecated.】

DEP0166：导入和导出目标中的双斜杠#>

【DEP0166: Double slashes in imports and exports targets】

类型：运行时

【Type: Runtime】

将包的导入和导出目标映射到包含双斜杠（“/”或“\”）的路径已被弃用，并且在未来版本中会因解析验证错误而失败。同样的弃用规则也适用于以斜杠开头或结尾的模式匹配。

【Package imports and exports targets mapping into paths including a double slash (of "/" or "\") are deprecated and will fail with a resolution validation error in a future release. This same deprecation also applies to pattern matches starting or ending in a slash.】

DEP0167：弱的 DiffieHellmanGroup 实例（modp1、modp2、modp5）#>

【DEP0167: Weak DiffieHellmanGroup instances (modp1, modp2, modp5)】

类型：仅文档

【Type: Documentation-only】

著名的 MODP 组 modp1、modp2 和 modp5 已被弃用，因为它们不能抵御实际攻击。详情见 RFC 8247 第 2.4 节。

【The well-known MODP groups modp1, modp2, and modp5 are deprecated because they are not secure against practical attacks. See RFC 8247 Section 2.4 for details.】

这些组可能会在未来的 Node.js 版本中被移除。依赖这些组的应用应考虑使用更强的 MODP 组。

【These groups might be removed in future versions of Node.js. Applications that rely on these groups should evaluate using stronger MODP groups instead.】

DEP0168：Node-API 回调中的未处理异常#>

【DEP0168: Unhandled exception in Node-API callbacks】

类型：运行时

【Type: Runtime】

现在已不推荐在 Node-API 回调中隐式抑制未捕获的异常。

【The implicit suppression of uncaught exceptions in Node-API callbacks is now deprecated.】

设置标志 --force-node-api-uncaught-exceptions-policy，以强制 Node.js 在 Node-API 回调中未处理异常时发出 'uncaughtException' 事件。

【Set the flag --force-node-api-uncaught-exceptions-policy to force Node.js to emit an 'uncaughtException' event if the exception is not handled in Node-API callbacks.】

DEP0169：不安全的 url.parse()#>

【DEP0169: Insecure url.parse()】

类型：仅文档（支持 --pending-deprecation）

【Type: Documentation-only (supports --pending-deprecation)】

url.parse() 的行为不标准且容易出错，这可能带来安全隐患。请改用 WHATWG URL API。url.parse() 的漏洞不会发布 CVE。

DEP0170：使用 url.parse() 时端口无效#>

【DEP0170: Invalid port when using url.parse()】

类型：运行时

【Type: Runtime】

url.parse() 接受端口不是数字的 URL。这种行为可能导致通过意外输入进行主机名欺骗。在未来版本的 Node.js 中，这些 URL 将会抛出错误，就像 WHATWG URL API 已经会一样。

DEP0171：http.IncomingMessage 头和尾的设置器#>

【DEP0171: Setters for http.IncomingMessage headers and trailers】

类型：仅文档

【Type: Documentation-only】

在未来版本的 Node.js 中，message.headers、message.headersDistinct、message.trailers 和 message.trailersDistinct 将为只读。

【In a future version of Node.js, message.headers, message.headersDistinct, message.trailers, and message.trailersDistinct will be read-only.】

DEP0172：绑定函数的 AsyncResource 的 asyncResource 属性#>

【DEP0172: The asyncResource property of AsyncResource bound functions】

类型：运行时

【Type: Runtime】

在未来的 Node.js 版本中，当函数绑定到 AsyncResource 时，将不再添加 asyncResource 属性。

【In a future version of Node.js, the asyncResource property will no longer be added when a function is bound to an AsyncResource.】

DEP0173：assert.CallTracker 类#>

【DEP0173: the assert.CallTracker class】

类型：运行时

【Type: Runtime】

在未来版本的 Node.js 中，assert.CallTracker 将被移除。请考虑使用诸如 mock 辅助函数之类的替代方案。

【In a future version of Node.js, assert.CallTracker, will be removed. Consider using alternatives such as the mock helper function.】

DEP0174：在返回 Promise 的函数上调用 promisify#>

【DEP0174: calling promisify on a function that returns a Promise】

类型：仅文档

【Type: Documentation-only】

在返回 Promise 的函数上调用 util.promisify 将忽略该 promise 的结果，这可能导致未处理的 promise 拒绝。

【Calling util.promisify on a function that returns a Promise will ignore the result of said promise, which can lead to unhandled promise rejections.】

DEP0175: util.toUSVString#>

类型：仅文档

【Type: Documentation-only】

util.toUSVString() API 已被弃用。请改用 String.prototype.toWellFormed。

【The util.toUSVString() API is deprecated. Please use String.prototype.toWellFormed instead.】

DEP0176: fs.F_OK、fs.R_OK、fs.W_OK、fs.X_OK#>

【DEP0176: fs.F_OK, fs.R_OK, fs.W_OK, fs.X_OK】

类型：仅文档

【Type: Documentation-only】

F_OK、R_OK、W_OK 和 X_OK 这些在 node:fs 上直接暴露的获取器已被弃用。请改为从 fs.constants 或 fs.promises.constants 获取它们。

DEP0177: util.types.isWebAssemblyCompiledModule#>

类型：寿命终止

【Type: End-of-Life】

util.types.isWebAssemblyCompiledModule API 已被移除。请改用 value instanceof WebAssembly.Module。

【The util.types.isWebAssemblyCompiledModule API has been removed. Please use value instanceof WebAssembly.Module instead.】

DEP0178: dirent.path#>

类型：仅文档

【Type: Documentation-only】

由于 dirent.path 在不同版本之间缺乏一致性，因此已被弃用。请改用 dirent.parentPath。

【The dirent.path is deprecated due to its lack of consistency across release lines. Please use dirent.parentPath instead.】

DEP0179：Hash 构造函数#>

【DEP0179: Hash constructor】

类型：仅文档

【Type: Documentation-only】

直接使用 Hash() 或 new Hash() 调用 Hash 类已被弃用，因为它属于内部实现，不适合公开使用。请使用 crypto.createHash() 方法来创建 Hash 实例。

【Calling Hash class directly with Hash() or new Hash() is deprecated due to being internals, not intended for public use. Please use the crypto.createHash() method to create Hash instances.】

DEP0180: fs.Stats 构造函数#>

【DEP0180: fs.Stats constructor】

类型：仅文档

【Type: Documentation-only】

直接调用 fs.Stats 类，例如使用 Stats() 或 new Stats() 已被弃用，因为它属于内部实现，不适合公开使用。

【Calling fs.Stats class directly with Stats() or new Stats() is deprecated due to being internals, not intended for public use.】

DEP0181：Hmac 构造函数#>

【DEP0181: Hmac constructor】

类型：仅文档

【Type: Documentation-only】

直接使用 Hmac() 或 new Hmac() 调用 Hmac 类已被弃用，因为它属于内部实现，不打算用于公共用途。请使用 crypto.createHmac() 方法来创建 Hmac 实例。

【Calling Hmac class directly with Hmac() or new Hmac() is deprecated due to being internals, not intended for public use. Please use the crypto.createHmac() method to create Hmac instances.】

DEP0182：未显式指定 authTagLength 的简短 GCM 认证标签#>

【DEP0182: Short GCM authentication tags without explicit authTagLength】

类型：仅文档（支持 --pending-deprecation）

【Type: Documentation-only (supports --pending-deprecation)】

打算使用比默认身份验证标签长度更短的身份验证标签的应用应将 crypto.createDecipheriv() 函数的 authTagLength 选项设置为适当的长度。

【Applications that intend to use authentication tags that are shorter than the default authentication tag length should set the authTagLength option of the crypto.createDecipheriv() function to the appropriate length.】

对于 GCM 模式下的密码，decipher.setAuthTag() 函数接受任意有效长度的认证标签（参见 DEP0090）。此行为已被弃用，以更好地符合 NIST SP 800-38D 的建议。

【For ciphers in GCM mode, the decipher.setAuthTag() function accepts authentication tags of any valid length (see DEP0090). This behavior is deprecated to better align with recommendations per NIST SP 800-38D.】

DEP0183：基于 OpenSSL 引擎的 API#>

【DEP0183: OpenSSL engine-based APIs】

类型：仅文档

【Type: Documentation-only】

OpenSSL 3 已弃用对自定义引擎的支持，并建议切换到其新的提供程序模型。https.request() 的 clientCertEngine 选项、tls.createSecureContext() 和 tls.createServer()；tls.createSecureContext() 的 privateKeyEngine 和 privateKeyIdentifier；以及 crypto.setEngine() 都依赖于 OpenSSL 的此功能。

【OpenSSL 3 has deprecated support for custom engines with a recommendation to switch to its new provider model. The clientCertEngine option for https.request(), tls.createSecureContext(), and tls.createServer(); the privateKeyEngine and privateKeyIdentifier for tls.createSecureContext(); and crypto.setEngine() all depend on this functionality from OpenSSL.】

DEP0184：在没有使用 new 的情况下实例化 node:zlib 类#>

【DEP0184: Instantiating node:zlib classes without new】

类型：仅文档

【Type: Documentation-only】

不使用“node：zlib”模块导出的“新”限定符实例化类将被弃用。 建议使用“新”限定词。这适用于所有 Zlib 类，如“Flatlate”， “放气Raw”、“枪拉链”、“Inflate”、“InflateRaw”、“Unzip”和“Zlib”。

【Instantiating classes without the new qualifier exported by the node:zlib module is deprecated. It is recommended to use the new qualifier instead. This applies to all Zlib classes, such as Deflate, DeflateRaw, Gunzip, Inflate, InflateRaw, Unzip, and Zlib.】

DEP0185：在没有使用 new 的情况下实例化 node:repl 类#>

【DEP0185: Instantiating node:repl classes without new】

类型：仅文档

【Type: Documentation-only】

在没有使用 new 修饰符的情况下实例化由 node:repl 模块导出的类已被弃用。建议改为使用 new 修饰符。这适用于所有 REPL 类，包括 REPLServer 和 Recoverable。

【Instantiating classes without the new qualifier exported by the node:repl module is deprecated. It is recommended to use the new qualifier instead. This applies to all REPL classes, including REPLServer and Recoverable.】

DEP0187：向 fs.existsSync 传递无效的参数类型#>

【DEP0187: Passing invalid argument types to fs.existsSync】

类型：仅文档

【Type: Documentation-only】

传递不支持的参数类型已被弃用，将来版本中不会返回 false，而是会抛出错误。

【Passing non-supported argument types is deprecated and, instead of returning false, will throw an error in a future version.】

DEP0192：require('node:_tls_common') 和 require('node:_tls_wrap')#>

【DEP0192: require('node:_tls_common') and require('node:_tls_wrap')】

类型：仅文档

【Type: Documentation-only】

node:_tls_common 和 node:_tls_wrap 模块已被弃用，因为它们应被视为 Node.js 的内部实现，而不是面向公共的 API，请改用 node:tls。

【The node:_tls_common and node:_tls_wrap modules are deprecated as they should be considered an internal nodejs implementation rather than a public facing API, use node:tls instead.】

DEP0193: require('node:_stream_*')#>

类型：仅文档

【Type: Documentation-only】

node:_stream_duplex、node:_stream_passthrough、node:_stream_readable、node:_stream_transform、node:_stream_wrap 和 node:_stream_writable 模块已被弃用，因为它们应被视为 Node.js 的内部实现，而不是面向公众的 API，应使用 node:stream 代替。

【The node:_stream_duplex, node:_stream_passthrough, node:_stream_readable, node:_stream_transform, node:_stream_wrap and node:_stream_writable modules are deprecated as they should be considered an internal nodejs implementation rather than a public facing API, use node:stream instead.】

DEP0194：HTTP/2 优先级信号#>

【DEP0194: HTTP/2 priority signaling】

类型：仅文档

【Type: Documentation-only】

在 RFC 9113 中，对优先级信号的支持已被弃用，并将在未来版本的 Node.js 中移除。

【The support for priority signaling has been deprecated in the RFC 9113, and will be removed in future versions of Node.js.】

DEP0198：在没有明确 options.outputLength 的情况下创建 SHAKE-128 和 SHAKE-256 摘要#>

【DEP0198: Creating SHAKE-128 and SHAKE-256 digests without an explicit options.outputLength】

类型：仅文档（支持 --pending-deprecation）

【Type: Documentation-only (supports --pending-deprecation)】

在没有明确指定 options.outputLength 的情况下创建 SHAKE-128 和 SHAKE-256 摘要已被弃用。

【Creating SHAKE-128 and SHAKE-256 digests without an explicit options.outputLength is deprecated.】