在线工具
网站地图    收藏    合作   
<

快捷菜单 返回顶部

node中文API-deprecation弃用

deprecation 弃用#

中英对照

Node.js API 可能由于以下任何原因而被弃用:

  • 该 API 的使用是不安全的。
  • 改进的替代 API 可用。
  • 预计在未来的主要版本中会对 API 进行重大更改。

Node.js 使用了三种弃用:

  • 仅文档
  • 运行时
  • 生命结束

仅文档弃用是仅在 Node.js API 文档中表达的弃用。 这些在运行 Node.js 时不会产生副作用。 某些仅文档的弃用在使用 --pending-deprecation 标志(或其替代的 NODE_PENDING_DEPRECATION=1 环境变量)启动时会触发运行时警告,类似于下面的运行时弃用。 支持该标志的仅文档弃用在弃用的 API 列表中明确标记为此类。

默认情况下,运行时弃用将生成进程警告,该警告将在第一次使用弃用的 API 时打印到 stderr。 当使用 --throw-deprecation 命令行标志时,运行时弃用将导致抛出错误。

当特性已经或即将从 Node.js 中删除时,使用生命结束的弃用。

撤销的弃用#

中英对照

有时,API 的弃用可能会被逆转。 在这种情况下,本文件将更新与决定相关的信息。 但是,弃用标识符不会被修改。

弃用的 API 列表#

DEP0001: http.OutgoingMessage.prototype.flush#

中英对照

类型: 生命结束

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

DEP0002: require('_linklist')#

中英对照

类型: 生命结束

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

DEP0003: _writableState.buffer#

中英对照

类型: 生命结束

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

DEP0004: CryptoStream.prototype.readyState#

中英对照

类型: 生命结束

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

DEP0005: Buffer() 构造函数#

中英对照

类型: 运行时(支持 --pending-deprecation

由于可能导致意外安全问题的 API 可用性问题,Buffer() 函数和 new Buffer() 构造函数已弃用。

作为替代方案,使用以下方法之一构造 Buffer 对象:

没有 --pending-deprecation,运行时警告只会出现在不在 node_modules 中的代码。 这意味着在依赖项中使用 Buffer() 不会出现弃用警告。 对于 --pending-deprecation,无论在何处使用 Buffer(),都会产生运行时警告。

DEP0006: child_process options.customFds#

中英对照

类型: 生命结束

child_process 模块的 spawn()fork()exec() 方法中,options.customFds 选项已弃用。 应该使用 options.stdio 选项。

DEP0007: 使用 worker.exitedAfterDisconnect 替换集群的 worker.suicide#

中英对照

类型: 生命结束

在 Node.js cluster 的早期版本中,名为 suicide 的布尔属性被添加到 Worker 对象中。 此属性的目的是提供 Worker 实例退出的方式和原因的指示。 在 Node.js 6.0.0 中, 旧属性已被弃用,并被新的 worker.exitedAfterDisconnect 属性替换。 旧版的属性名称没有准确描述实际的语义,并且不必要地充满了情感。

DEP0008: require('constants')#

中英对照

类型: 仅文档

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

DEP0009: 没有摘要的 crypto.pbkdf2#

中英对照

类型: 生命结束

在 Node.js 6.0 中,不指定摘要的 crypto.pbkdf2() API 已弃用,因为该方法默认使用非推荐的 'SHA1' 摘要。 以前,打印过弃用警告。 从 Node.js 8.0.0 开始,在 digest 设置为 undefined 的情况下调用 crypto.pbkdf2()crypto.pbkdf2Sync() 将抛出 TypeError

从 Node.js v11.0.0 开始,在 digest 设置为 null 的情况下调用这些函数将打印弃用警告,以与 digestundefined 时的行为保持一致。

但是现在,通过 undefinednull 将抛出 TypeError

DEP0010: crypto.createCredentials#

中英对照

类型: 生命结束

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

DEP0011: crypto.Credentials#

中英对照

类型: 生命结束

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

DEP0012: Domain.dispose#

中英对照

类型: 生命结束

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

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

中英对照

类型: 生命结束

在 Node.js 10.0.0 及更高版本中调用没有回调的异步函数会引发 TypeError。 参阅 https://github.com/nodejs/node/pull/12562

DEP0014: fs.read 旧版的字符串接口#

中英对照

类型: 生命结束

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

DEP0015: fs.readSync 旧版的字符串接口#

中英对照

类型: 生命结束

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

DEP0016: GLOBAL/root#

中英对照

类型: 生命结束

global 属性的 GLOBALroot 别名在 Node.js 6.0.0 中已弃用,此后已被删除。

DEP0017: Intl.v8BreakIterator#

中英对照

类型: 生命结束

Intl.v8BreakIterator 是非标准的扩展,已被删除。 参阅 Intl.Segmenter

DEP0018: 未处理的 promise 拒绝#

中英对照

类型: 生命结束

未处理的 promise 拒绝已弃用。 默认情况下,未处理的 promise 拒绝会以非零退出代码终止 Node.js 进程。 要改变 Node.js 处理未处理拒绝的方式,则使用 --unhandled-rejections 命令行选项。

DEP0019: require('.') 在目录外解析#

中英对照

类型: 生命结束

在某些情况下,require('.') 可以在包目录之外解析。 此行为已被删除。

DEP0020: Server.connections#

中英对照

类型: 生命结束

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

DEP0021: Server.listenFD#

中英对照

类型: 生命结束

Server.listenFD() 方法已被弃用并删除。 请改用 Server.listen({fd: <number>})

DEP0022: os.tmpDir()#

中英对照

类型: 生命结束

os.tmpDir() API 在 Node.js 7.0.0 中已被弃用,此后已被删除。 请改用 os.tmpdir()

DEP0023: os.getNetworkInterfaces()#

中英对照

类型: 生命结束

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

DEP0024: REPLServer.prototype.convertToContext()#

中英对照

类型: 生命结束

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

DEP0025: require('sys')#

中英对照

类型: 运行时

sys 模块已弃用。 请改用 util 模块。

DEP0026: util.print()#

中英对照

类型: 生命结束

util.print() 已被删除。 请改用 console.log()

DEP0027: util.puts()#

中英对照

类型: 生命结束

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

DEP0028: util.debug()#

中英对照

类型: 生命结束

util.debug() 已被删除。 请改用 console.error()

DEP0029: util.error()#

中英对照

类型: 生命结束

util.error() 已被删除。 请改用 console.error()

DEP0030: SlowBuffer#

中英对照

类型: 仅文档

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

DEP0031: ecdh.setPublicKey()#

中英对照

类型: 仅文档

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

DEP0032: domain 模块#

中英对照

类型: 仅文档

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

DEP0033: EventEmitter.listenerCount()#

中英对照

类型: 仅文档

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

DEP0034: fs.exists(path, callback)#

中英对照

类型: 仅文档

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

DEP0035: fs.lchmod(path, mode, callback)#

中英对照

类型: 仅文档

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

DEP0036: fs.lchmodSync(path, mode)#

中英对照

类型: 仅文档

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

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

中英对照

类型: 弃用已撤销

fs.lchown(path, uid, gid, callback) API 已被弃用。 由于在 libuv 中添加了必要的支持 API,因此弃用已被撤销。

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

中英对照

类型: 弃用已撤销

fs.lchownSync(path, uid, gid) API 已被弃用。 由于在 libuv 中添加了必要的支持 API,因此弃用已被撤销。

DEP0039: require.extensions#

中英对照

类型: 仅文档

require.extensions 属性已弃用。

DEP0040: punycode 模块#

中英对照

类型: 仅文档(支持 --pending-deprecation

punycode 模块已弃用。 请使用用户空间替代方案。

DEP0041: NODE_REPL_HISTORY_FILE 环境变量#

中英对照

类型: 生命结束

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

DEP0042: tls.CryptoStream#

中英对照

类型: 生命结束

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

DEP0043: tls.SecurePair#

中英对照

类型: 仅文档

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

DEP0044: util.isArray()#

中英对照

类型: 仅文档

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

DEP0045: util.isBoolean()#

中英对照

类型: 仅文档

util.isBoolean() API 已弃用。

DEP0046: util.isBuffer()#

中英对照

类型: 仅文档

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

DEP0047: util.isDate()#

中英对照

类型: 仅文档

util.isDate() API 已弃用。

DEP0048: util.isError()#

中英对照

类型: 仅文档

util.isError() API 已弃用。

DEP0049: util.isFunction()#

中英对照

类型: 仅文档

util.isFunction() API 已弃用。

DEP0050: util.isNull()#

中英对照

类型: 仅文档

util.isNull() API 已弃用。

DEP0051: util.isNullOrUndefined()#

中英对照

类型: 仅文档

util.isNullOrUndefined() API 已弃用。

DEP0052: util.isNumber()#

中英对照

类型: 仅文档

util.isNumber() API 已弃用。

DEP0053: util.isObject()#

中英对照

类型: 仅文档

util.isObject() API 已弃用。

DEP0054: util.isPrimitive()#

中英对照

类型: 仅文档

util.isPrimitive() API 已弃用。

DEP0055: util.isRegExp()#

中英对照

类型: 仅文档

util.isRegExp() API 已弃用。

DEP0056: util.isString()#

中英对照

类型: 仅文档

util.isString() API 已弃用。

DEP0057: util.isSymbol()#

中英对照

类型: 仅文档

util.isSymbol() API 已弃用。

DEP0058: util.isUndefined()#

中英对照

类型: 仅文档

util.isUndefined() API 已弃用。

DEP0059: util.log()#

中英对照

类型: 仅文档

util.log() API 已弃用。

DEP0060: util._extend()#

中英对照

类型: 仅文档

util._extend() API 已弃用。

DEP0061: fs.SyncWriteStream#

中英对照

自学PHP网专注网站建设学习,PHP程序学习,平面设计学习,以及操作系统学习

京ICP备14009008号@版权所有www.zixuephp.com

网站声明:本站所有视频,教程都由网友上传,站长收集和分享给大家学习使用,如由牵扯版权问题请联系站长邮箱904561283@qq.com