Глобальные объекты
Эти объекты доступны во всех модулях.
Следующие переменные могут казаться глобальными, но таковыми не являются. Они существуют только в области видимости CommonJS модулей:
Перечисленные здесь объекты специфичны для Node.js. Существуют встроенные объекты, которые являются частью самого языка JavaScript и также доступны глобально.
Класс: AbortController
Утилитарный класс, используемый для сигнализации об отмене в выбранных 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])
-
reason<любое> Необязательный параметр reason, доступный в свойствеAbortSignalобъектаreason.
Вызывает сигнал отмены, заставляя abortController.signal выдать событие 'abort'.
abortController.signal
- Тип: <AbortSignal>
Класс: AbortSignal
- Расширяет: <EventTarget>
AbortSignal используется для уведомления наблюдателей, когда вызывается метод abortController.abort().
Статический метод: AbortSignal.abort([reason])
-
reason: <любое> - Возвращает: <AbortSignal>
Возвращает новый уже прерванный AbortSignal.
Статический метод: AbortSignal.timeout(delay)
-
delay<число> Количество миллисекунд ожидания перед вызовом AbortSignal.
Возвращает новый AbortSignal, который будет прерван через delay миллисекунд.
Статический метод: AbortSignal.any(signals)
-
signals<AbortSignal[]>AbortSignal, из которых составляется новыйAbortSignal.
Возвращает новый AbortSignal, который будет прерван, если любой из предоставленных сигналов будет прерван. Его свойство abortSignal.reason будет установлено в значение того сигнала, из-за которого он был прерван.
Событие: 'abort'
Событие 'abort' генерируется, когда вызывается метод abortController.abort(). Обработчик вызывается с единственным объектом-аргументом, содержащим свойство type, установленное в '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(); copy AbortController, с которым связан AbortSignal, будет вызывать событие 'abort' только один раз. Рекомендуется проверять атрибут abortSignal.aborted на false перед добавлением обработчика события 'abort'.
Любые обработчики событий, прикрепленные к AbortSignal должны использовать опцию { once: true } (или, если используется EventEmitter API для добавления обработчика, метод once()) для гарантии удаления обработчика как только событие 'abort' будет обработано. Невыполнение этого может привести к утечке памяти.
abortSignal.aborted
- Тип: <логическое> Истинно после того, как
AbortControllerбыл прерван.
abortSignal.onabort
- Тип: <Функция>
Необязательная функция обратного вызова, которую можно установить кодом пользователя, чтобы быть уведомленным, когда была вызвана функция abortController.abort().
abortSignal.reason
- Тип: <любое>
Необязательное значение reason, указанное при вызове AbortSignal.
const ac = new AbortController();
ac.abort(new Error('boom!'));
console.log(ac.signal.reason); // Error: boom! copy
abortSignal.throwIfAborted()
Если abortSignal.aborted равно true, выбрасывается abortSignal.reason.
Класс: Blob
См. <Blob>.
Класс: Buffer
Используется для обработки двоичных данных. Смотрите раздел Buffer.
Класс: ByteLengthQueuingStrategy
Реализация, совместимая с браузером, ByteLengthQueuingStrategy.
__dirname
Эта переменная может казаться глобальной, но таковой не является. Смотрите __dirname.
__filename
Эта переменная может казаться глобальной, но таковой не является. Смотрите __filename.
atob(data)
Buffer.from(data, 'base64') вместо этого.Глобальный псевдоним для buffer.atob().
BroadcastChannel
См. <BroadcastChannel>.
btoa(data)
buf.toString('base64') вместо этого.Глобальный псевдоним для buffer.btoa().
clearImmediate(immediateObject)
clearImmediate описана в разделе timers.
clearInterval(intervalObject)
clearInterval описана в разделе timers.
clearTimeout(timeoutObject)
clearTimeout описана в разделе timers.
Класс: CompressionStream
Реализация, совместимая с браузером, CompressionStream.
console
Используется для вывода в stdout и stderr. Смотрите раздел console.
Класс: CountQueuingStrategy
Реализация, совместимая с браузером, класса CountQueuingStrategy.
Crypto
--no-experimental-global-webcrypto.Реализация, совместимая с браузером, объекта <Crypto>. Этот глобальный объект доступен только в том случае, если бинарник Node.js был скомпилирован с включенной поддержкой модуля node:crypto.
crypto
--no-experimental-global-webcrypto.Реализация, совместимая с браузером, API Web Crypto.
CryptoKey
--no-experimental-global-webcrypto.Реализация, совместимая с браузером, класса <CryptoKey>. Этот глобальный объект доступен только в том случае, если бинарник Node.js был скомпилирован с включенной поддержкой модуля node:crypto.
CustomEvent
--no-experimental-global-customevent.Реализация, совместимая с браузером, CustomEvent API.
Класс: DecompressionStream
Реализация, совместимая с браузером, класса DecompressionStream.
Event
Реализация, совместимая с браузером, класса Event. Подробнее см. EventTarget и Event API.
EventTarget
Реализация, совместимая с браузером, класса EventTarget. Подробнее см. EventTarget и Event API.
exports
Эта переменная может казаться глобальной, но таковой не является. См. exports.
fetch
--no-experimental-fetch.Реализация, совместимая с браузером, функции fetch().
Класс: File
См. <File>.
Класс FormData
--no-experimental-fetch.Реализация, совместимая с браузером, класса <FormData>.
global
globalThis вместо этого.- <Object> Объект глобального пространства имён.
В браузерах верхний уровень области видимости традиционно является глобальной областью видимости. Это означает, что var something определит новую глобальную переменную, за исключением случаев внутри ECMAScript-модулей. В Node.js это отличается. Верхний уровень области видимости не является глобальной областью видимости; var something внутри модуля Node.js будет локальным для этого модуля, независимо от того, является ли он модулем CommonJS или ECMAScript-модулем.
Класс Headers
--no-experimental-fetch.Реализация, совместимая с браузером, класса <Headers>.
MessageChannel
Класс MessageChannel. Подробнее см. MessageChannel.
MessageEvent
Класс MessageEvent. Подробнее см. MessageEvent.
MessagePort
Класс MessagePort. Подробнее см. MessagePort.
module
Эта переменная может казаться глобальной, но таковой не является. См. module.
PerformanceEntry
Класс PerformanceEntry. Подробнее см. PerformanceEntry.
PerformanceMark
Класс PerformanceMark. Подробнее см. PerformanceMark.
PerformanceMeasure
Класс PerformanceMeasure. Подробнее см. PerformanceMeasure.
PerformanceObserver
Класс PerformanceObserver. См. PerformanceObserver для более подробной информации.
PerformanceObserverEntryList
Класс PerformanceObserverEntryList. См. PerformanceObserverEntryList для более подробной информации.
PerformanceResourceTiming
Класс PerformanceResourceTiming. См. PerformanceResourceTiming для более подробной информации.
performance
Объект perf_hooks.performance.
process
Объект process. См. раздел process объекта.
queueMicrotask(callback)
-
callback<Функция> Функция, которая будет помещена в очередь.
Метод queueMicrotask() помещает в очередь микрозадачу для вызова callback. Если callback вызывает исключение, будет отправлено событие 'uncaughtException' объекта process объекта.
Очередь микрозадач управляется V8 и может быть использована аналогично очереди process.nextTick(), которая управляется Node.js. Очередь process.nextTick() всегда обрабатывается перед очередью микрозадач в каждом цикле событий Node.js.
// 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);
}; copy Class: ReadableByteStreamController
Реализация класса ReadableByteStreamController, совместимая с браузером.
Class: ReadableStream
Реализация класса ReadableStream, совместимая с браузером.
Class: ReadableStreamBYOBReader
Реализация класса ReadableStreamBYOBReader, совместимая с браузером.
Class: ReadableStreamBYOBRequest
Реализация класса ReadableStreamBYOBRequest, совместимая с браузером.
Class: ReadableStreamDefaultController
Реализация класса ReadableStreamDefaultController, совместимая с браузером.
Class: ReadableStreamDefaultReader
Реализация класса ReadableStreamDefaultReader, совместимая с браузером.
require()
Эта переменная может казаться глобальной, но таковой не является. См. require().
Response
--no-experimental-fetch.Реализация класса <Response>, совместимая с браузером.
Request
--no-experimental-fetch.Реализация класса <Request>, совместимая с браузером.
setImmediate(callback[, ...args])
setImmediate описан в разделе timers.
setInterval(callback, delay[, ...args])
setInterval описан в разделе timers.
setTimeout(callback, delay[, ...args])
setTimeout описан в разделе timers.
structuredClone(value[, options])
Метод WHATWG structuredClone.
SubtleCrypto
--no-experimental-global-webcrypto.Реализация класса <SubtleCrypto>, совместимая с браузером. Этот глобальный объект доступен только в том случае, если бинарник Node.js был скомпилирован с включением поддержки модуля node:crypto.
DOMException
Класс WHATWG DOMException. См. DOMException для более подробной информации.
TextDecoder
Класс WHATWG TextDecoder. См. раздел TextDecoder.
Class: TextDecoderStream
Реализация класса TextDecoderStream, совместимая с браузером.
TextEncoder
Класс WHATWG TextEncoder. См. раздел TextEncoder.
Class: TextEncoderStream
Реализация класса TextEncoderStream, совместимая с браузером.
Class: TransformStream
Реализация класса TransformStream, совместимая с браузером.
Класс: TransformStreamDefaultController
Реализация, совместимая с браузером, класса TransformStreamDefaultController.
URL
Класс WHATWG URL. См. раздел URL.
URLSearchParams
Класс WHATWG URLSearchParams. См. раздел URLSearchParams.
WebAssembly
Объект, который выступает в качестве пространства имён для всех функций W3C, связанных с WebAssembly. Для использования и совместимости см. Mozilla Developer Network.
WebSocket
Реализация, совместимая с браузером, класса WebSocket. Включите этот API с помощью флага командной строки --experimental-websocket.
Класс: WritableStream
Реализация, совместимая с браузером, класса WritableStream.
Класс: WritableStreamDefaultController
Реализация, совместимая с браузером, класса WritableStreamDefaultController.
Класс: WritableStreamDefaultWriter
Реализация, совместимая с браузером, класса WritableStreamDefaultWriter.
© Joyent, Inc. and other Node contributors
Licensed under the MIT License.
Node.js is a trademark of Joyent, Inc. and is used with its permission.
We are not endorsed by or affiliated with Joyent.
https://nodejs.org/dist/latest-v20.x/docs/api/globals.html