Node.js v16.20.2 文档

类：AbortController#>

【Class: AbortController】

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

【A utility class used to signal cancelation in selected Promise-based APIs. The API is based on the 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 拷贝

abortController.abort([reason])#>

• reason <any> 一个可选的原因，可以通过 AbortSignal 的 reason 属性获取。

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

【Triggers the abort signal, causing the abortController.signal to emit the 'abort' event.】

abortController.signal#>

• 类型：<AbortSignal>

类：AbortSignal#>

【Class: AbortSignal】

• 扩展：<EventTarget>

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

【The AbortSignal is used to notify observers when the abortController.abort() method is called.】

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

【Static method: AbortSignal.abort([reason])】

• reason: <any>
• 返回：<AbortSignal>

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

【Returns a new already aborted AbortSignal.】

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

【Static method: AbortSignal.timeout(delay)】

• delay <number> 在触发 AbortSignal 之前等待的毫秒数。

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

【Returns a new AbortSignal which will be aborted in delay milliseconds.】

事件：'abort'#>

【Event: 'abort'】

当调用 abortController.abort() 方法时，会触发 'abort' 事件。回调函数会使用一个包含单个 type 属性且值为 'abort' 的对象作为参数被调用：

【The 'abort' event is emitted when the abortController.abort() method is called. The callback is invoked with a single object argument with a single type property set to 'abort':】

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(); 拷贝

AbortSignal 所关联的 AbortController 只会触发一次 'abort' 事件。我们建议在添加 'abort' 事件监听器之前，代码先检查 abortSignal.aborted 属性是否为 false。

【The AbortController with which the AbortSignal is associated will only ever trigger the 'abort' event once. We recommended that code check that the abortSignal.aborted attribute is false before adding an 'abort' event listener.】

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

【Any event listeners attached to the AbortSignal should use the { once: true } option (or, if using the EventEmitter APIs to attach a listener, use the once() method) to ensure that the event listener is removed as soon as the 'abort' event is handled. Failure to do so may result in memory leaks.】

abortSignal.aborted#>

• 类型：<boolean> 在 AbortController 被中止后为 true。

abortSignal.onabort#>

• 类型：<Function>

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

【An optional callback function that may be set by user code to be notified when the abortController.abort() function has been called.】

abortSignal.reason#>

• 类型：<any>

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

【An optional reason specified when the AbortSignal was triggered.】

const ac = new AbortController();
ac.abort(new Error('boom!'));
console.log(ac.signal.reason);  // Error('boom!'); 拷贝

abortSignal.throwIfAborted()#>

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

【If abortSignal.aborted is true, throws abortSignal.reason.】

类：Buffer#>

【Class: Buffer】

• <Function>

用于处理二进制数据。请参见 缓冲区段。

【Used to handle binary data. See the buffer section.】

__dirname#>

这个变量看起来可能是全局的，但实际上不是。参见 __dirname。

【This variable may appear to be global but is not. See __dirname.】

__filename#>

这个变量看起来可能是全局的，但实际上不是。参见 __filename。

【This variable may appear to be global but is not. See __filename.】

atob(data)#>

buffer.atob() 的全球别名。

【Global alias for buffer.atob().】

btoa(data)#>

buffer.btoa() 的全球别名。

【Global alias for buffer.btoa().】

clearImmediate(immediateObject)#>

clearImmediate 在 定时器 部分中有所描述。

clearInterval(intervalObject)#>

clearInterval 在 定时器 部分中有所描述。

clearTimeout(timeoutObject)#>

clearTimeout 在 定时器 部分中有描述。

console#>

• <Object>

用于打印到标准输出和标准错误。请参见 console 部分。

【Used to print to stdout and stderr. See the console section.】

Crypto#>

一个与浏览器兼容的 <Crypto> 实现。仅当 Node.js 二进制文件在编译时包含对 node:crypto 模块的支持时，才可使用此全局对象。

【A browser-compatible implementation of <Crypto>. This global is available only if the Node.js binary was compiled with including support for the node:crypto module.】

crypto#>

网络加密 API 的浏览器兼容实现。

【A browser-compatible implementation of the Web Crypto API.】

CryptoKey#>

兼容浏览器的 <CryptoKey> 实现。仅当 Node.js 二进制文件在编译时包含对 node:crypto 模块的支持时，此全局变量才可用。

【A browser-compatible implementation of <CryptoKey>. This global is available only if the Node.js binary was compiled with including support for the node:crypto module.】

CustomEvent#>

CustomEvent Web API 的浏览器兼容实现。

【A browser-compatible implementation of the CustomEvent Web API.】

Event#>

一个与浏览器兼容的 Event 类实现。更多详情请参见 EventTarget 和 Event API。

【A browser-compatible implementation of the Event class. See EventTarget and Event API for more details.】

EventTarget#>

EventTarget 类的浏览器兼容实现。更多详情请参见 EventTarget 和 Event API。

【A browser-compatible implementation of the EventTarget class. See EventTarget and Event API for more details.】

exports#>

这个变量看起来可能是全局的，但实际上不是。参见 exports。

【This variable may appear to be global but is not. See exports.】

fetch#>

一个与浏览器兼容的 fetch() 函数实现。

【A browser-compatible implementation of the fetch() function.】

类 FormData#>

【Class FormData】

一个与浏览器兼容的 <FormData> 实现。

【A browser-compatible implementation of <FormData>.】

global#>

• <Object> 全局命名空间对象。

在浏览器中，顶层作用域是全局作用域。这意味着在浏览器中，var something 会定义一个新的全局变量。在 Node.js 中情况则不同。顶层作用域并非全局作用域；在 Node.js 模块中，var something 将只在该模块内局部有效。

【In browsers, the top-level scope is the global scope. This means that within the browser var something will define a new global variable. In Node.js this is different. The top-level scope is not the global scope; var something inside a Node.js module will be local to that module.】

类 Headers#>

【Class Headers】

一个与浏览器兼容的 <Headers> 实现。

【A browser-compatible implementation of <Headers>.】

MessageChannel#>

MessageChannel 类。更多详情请参见 MessageChannel。

【The MessageChannel class. See MessageChannel for more details.】

MessageEvent#>

MessageEvent 类。更多详情请参见 MessageEvent。

【The MessageEvent class. See MessageEvent for more details.】

MessagePort#>

MessagePort 类。更多详情请参见 MessagePort。

【The MessagePort class. See MessagePort for more details.】

module#>

这个变量看起来可能是全局的，但实际上不是。参见 module。

【This variable may appear to be global but is not. See module.】

performance#>

perf_hooks.performance 对象。

【The perf_hooks.performance object.】

process#>

• <Object>

process 对象。请参阅 process 对象 部分。

【The process object. See the process object section.】

queueMicrotask(callback)#>

• callback <Function> 要排队的函数。

queueMicrotask() 方法将微任务排队以调用 callback。如果 callback 抛出异常，将触发 process 对象 'uncaughtException' 事件。

【The queueMicrotask() method queues a microtask to invoke callback. If callback throws an exception, the process object 'uncaughtException' event will be emitted.】

微任务队列由 V8 管理，并且可以以类似于由 Node.js 管理的 process.nextTick() 队列的方式使用。在 Node.js 事件循环的每一轮中，process.nextTick() 队列总是在微任务队列之前处理。

【The microtask queue is managed by V8 and may be used in a similar manner to the process.nextTick() queue, which is managed by Node.js. The process.nextTick() queue is always processed before the microtask queue within each turn of the Node.js event loop.】

// Here, `queueMicrotask()` is used to ensure the 'load' event is always
// emitted asynchronously, and therefore consistently. Using
// `process.nextTick()` here would result in the 'load' event always emitting
// before any other promise jobs.

DataHandler.prototype.load = async function load(key) {
  const hit = this._cache.get(key);
  if (hit !== undefined) {
    queueMicrotask(() => {
      this.emit('load', hit);
    });
    return;
  }

  const data = await fetchData(key);
  this._cache.set(key, data);
  this.emit('load', data);
}; 拷贝

require()#>

这个变量看起来可能是全局的，但实际上不是。参见 require()。

【This variable may appear to be global but is not. See require().】

Response#>

一个与浏览器兼容的 <Response> 实现。

【A browser-compatible implementation of <Response>.】

Request#>

一个与浏览器兼容的 <Request> 实现。

【A browser-compatible implementation of <Request>.】

setImmediate(callback[, ...args])#>

setImmediate 在 定时器 部分中有所描述。

setInterval(callback, delay[, ...args])#>

setInterval 在 定时器 部分中有所描述。

setTimeout(callback, delay[, ...args])#>

setTimeout 在 定时器 部分中有所描述。

SubtleCrypto#>

一个与浏览器兼容的 <SubtleCrypto> 实现。仅当 Node.js 二进制文件在编译时包含对 node:crypto 模块的支持时，才可使用此全局对象。

【A browser-compatible implementation of <SubtleCrypto>. This global is available only if the Node.js binary was compiled with including support for the node:crypto module.】

TextDecoder#>

WHATWG TextDecoder 类。请参见 TextDecoder 节。

【The WHATWG TextDecoder class. See the TextDecoder section.】

TextEncoder#>

WHATWG TextEncoder 类。请参见 TextEncoder 节。

【The WHATWG TextEncoder class. See the TextEncoder section.】

URL#>

WHATWG 的 URL 类。参见 URL 节。

【The WHATWG URL class. See the URL section.】

URLSearchParams#>

WHATWG 的 URLSearchParams 类。参见 URLSearchParams 部分。

【The WHATWG URLSearchParams class. See the URLSearchParams section.】

WebAssembly#>

• <Object>

作为所有 W3C WebAssembly 相关功能命名空间的对象。有关用法和兼容性，请参见 Mozilla 开发者网络。

【The object that acts as the namespace for all W3C WebAssembly related functionality. See the Mozilla Developer Network for usage and compatibility.】