全局对象#

全局对象#

这些对象在所有模块中都可用。

以下变量可能看起来是全局的，但实际上不是。它们仅存在于 CommonJS 模块的作用域中

__dirname

__filename

exports

module

require()

此处列出的对象是 Node.js 特有的。还有一些 内置对象是 JavaScript 语言本身的一部分，也可以全局访问。

类：AbortController#

历史

版本变更

v15.4.0

不再是实验性的。

v15.0.0, v14.17.0

添加于：v15.0.0, v14.17.0

稳定性：2 - 稳定

一个实用工具类，用于在选定的基于 Promise 的 API 中发出取消信号。 该 API 基于 Web API AbortController。

const ac = new AbortController();

ac.signal.addEventListener('abort', () => console.log('Aborted!'),

{ once: true });

ac.abort();

console.log(ac.signal.aborted); // Prints true copy

abortController.abort([reason])#

历史

版本变更

v17.2.0, v16.14.0

添加了新的可选 reason 参数。

v15.0.0, v14.17.0

添加于：v15.0.0, v14.17.0

reason 一个可选的原因，可在 AbortSignal 的 reason 属性上检索。

触发中止信号，导致 abortController.signal 发出 'abort' 事件。

abortController.signal#

添加于：v15.0.0, v14.17.0

类型：

类：AbortSignal#

添加于：v15.0.0, v14.17.0

继承：

当调用 abortController.abort() 方法时，AbortSignal 用于通知观察者。

静态方法：AbortSignal.abort([reason])#

历史

版本变更

v17.2.0, v16.14.0

添加了新的可选 reason 参数。

v15.12.0, v14.17.0

添加于：v15.12.0, v14.17.0

reason：

返回：

返回一个新的已中止的 AbortSignal。

静态方法：AbortSignal.timeout(delay)#

添加于：v17.3.0, v16.14.0

delay 在触发 AbortSignal 之前等待的毫秒数。

返回一个新的 AbortSignal，它将在 delay 毫秒后中止。

静态方法：AbortSignal.any(signals)#

添加于：v20.3.0, v18.17.0

signals 用于组成新的 AbortSignal 的 AbortSignal。

返回一个新的 AbortSignal，如果提供的任何信号被中止，它将被中止。 它的 abortSignal.reason 将设置为导致其中止的 signals 中的任何一个。

事件：'abort'#

添加于：v15.0.0, v14.17.0

当调用 abortController.abort() 方法时，会发出 'abort' 事件。 使用设置为 'abort' 的单个 type 属性调用回调函数。

const ac = new AbortController();

// Use either the onabort property...

ac.signal.onabort = () => console.log('aborted!');

// Or the EventTarget API...

ac.signal.addEventListener('abort', (event) => {

console.log(event.type); // Prints 'abort'

}, { once: true });

ac.abort(); copy

与 AbortSignal 关联的 AbortController 将仅触发一次 'abort' 事件。 我们建议代码在添加 'abort' 事件侦听器之前检查 abortSignal.aborted 属性是否为 false。

附加到 AbortSignal 的任何事件侦听器都应使用 { once: true } 选项（或者，如果使用 EventEmitter API 附加侦听器，则使用 once() 方法）以确保在处理 'abort' 事件后立即删除事件侦听器。 否则可能会导致内存泄漏。

abortSignal.aborted#

添加于：v15.0.0, v14.17.0

类型： 在 AbortController 中止后为 True。

abortSignal.onabort#

添加于：v15.0.0, v14.17.0

类型：

用户代码可以设置一个可选的回调函数，以便在调用 abortController.abort() 函数时收到通知。

abortSignal.reason#

添加于：v17.2.0, v16.14.0

类型：

触发 AbortSignal 时指定的可选原因。

const ac = new AbortController();

ac.abort(new Error('boom!'));

console.log(ac.signal.reason); // Error: boom! copy

abortSignal.throwIfAborted()#

添加于：v17.3.0, v16.17.0

如果 abortSignal.aborted 是 true，则抛出 abortSignal.reason。

类：Blob#

添加于：v18.0.0

稳定性：2 - 稳定

参阅 。

类：Buffer#

添加于：v0.1.103

稳定性：2 - 稳定

用于处理二进制数据。 请参阅 缓冲区部分。

类：ByteLengthQueuingStrategy#

历史

版本变更

v23.11.0, v22.15.0

将 API 标记为稳定。

v18.0.0

添加于：v18.0.0

与浏览器兼容的 ByteLengthQueuingStrategy 实现。

__dirname#

此变量可能看起来是全局的，但实际上不是。 请参阅 __dirname。

__filename#

此变量可能看起来是全局的，但实际上不是。 请参阅 __filename。

atob(data)#

添加于：v16.0.0

稳定性：3 - 遗留。 请改用 Buffer.from(data, 'base64')。

buffer.atob() 的全局别名。

BroadcastChannel#

添加于：v18.0.0

稳定性：2 - 稳定

参见 。

btoa(data)#

添加于：v16.0.0

稳定性: 3 - 已过时。 请改用 buf.toString('base64')。

buffer.btoa() 的全局别名。

clearImmediate(immediateObject)#

新增于: v0.9.1

稳定性：2 - 稳定

clearImmediate 在 计时器 部分中描述。

clearInterval(intervalObject)#

新增于: v0.0.1

稳定性：2 - 稳定

clearInterval 在 计时器 部分中描述。

clearTimeout(timeoutObject)#

新增于: v0.0.1

稳定性：2 - 稳定

clearTimeout 在 计时器 部分中描述。

CloseEvent#

新增于: v23.0.0

稳定性：2 - 稳定

CloseEvent 类。 更多详细信息，请参阅 CloseEvent。

CloseEvent 的浏览器兼容实现。 使用 --no-experimental-websocket CLI 标志禁用此 API。

类: CompressionStream#

历史

版本变更

v23.11.0, v22.15.0

将 API 标记为稳定。

v18.0.0

添加于：v18.0.0

CompressionStream 的浏览器兼容实现。

console#

新增于: v0.1.100

稳定性：2 - 稳定