Spec-Zone.ru › Node.js 16 LTS

Глобальные объекты

Эти объекты доступны во всех модулях. Следующие переменные могут казаться глобальными, но таковыми не являются. Они существуют только в области видимости модулей, см. документацию по системе модулей:

  • __dirname
  • __filename
  • exports
  • module
  • require()

Перечисленные здесь объекты специфичны для Node.js. Существуют встроенные объекты, которые являются частью самого языка JavaScript и также доступны глобально.

Класс: AbortController

История
Версия Изменения
v15.4.0

Больше не экспериментальный.

v15.0.0

Добавлен в: v15.0.0

Утилитный класс, используемый для сигнализации о прерывании в выбранных 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

abortController.abort()

Добавлен в: v15.0.0

Вызывает сигнал прерывания, заставляя abortController.signal генерировать событие 'abort'.

abortController.signal

Добавлен в: v15.0.0
  • Тип: <AbortSignal>

Класс: AbortSignal

Добавлен в: v15.0.0
  • Расширяет: <EventTarget>

Класс AbortSignal используется для уведомления наблюдателей, когда вызывается метод abortController.abort().

Статический метод: AbortSignal.abort()
Добавлен в: v15.12.0
  • Возвращает: <AbortSignal>

Возвращает новый уже прерванный AbortSignal.

Событие: 'abort'
Добавлен в: v15.0.0

Событие '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();

Объект AbortController, с которым связан AbortSignal, будет генерировать событие 'abort' только один раз. Рекомендуется проверять атрибут abortSignal.aborted на false перед добавлением обработчика события 'abort'.

Любые обработчики событий, прикрепленные к AbortSignal , должны использовать опцию { once: true } (или, если используются API для прикрепления обработчика, метод EventEmitter), чтобы гарантировать удаление обработчика как только событие 'abort' будет обработано. Игнорирование этого может привести к утечкам памяти.

abortSignal.aborted
Добавлен в: v15.0.0
  • Тип: <boolean> Истинно после прерывания AbortController.
abortSignal.onabort
Добавлен в: v15.0.0
  • Тип: <Функция>

Необязательная функция обратного вызова, которую пользовательский код может установить для уведомления о вызове функции abortController.abort().

Класс: Buffer

Добавлен в: v0.1.103
  • <Функция>

Используется для работы с двоичными данными. Смотрите раздел буфера.

__dirname

Эта переменная может казаться глобальной, но таковой не является. См. __dirname.

__filename

Эта переменная может казаться глобальной, но таковой не является. См. __filename.

atob(data)

Добавлен в: v16.0.0
Устойчивость: 3 - Устаревшее. Используйте Buffer.from(data, 'base64') вместо этого.

Глобальный псевдоним для buffer.atob().

btoa(data)

Добавлен в: v16.0.0
Устойчивость: 3 - Устаревшее. Используйте buf.toString('base64') вместо этого.

Глобальный псевдоним для buffer.btoa().

clearImmediate(immediateObject)

Добавлен в: v0.9.1

clearImmediate описан в разделе таймеры.

clearInterval(intervalObject)

Добавлен в: v0.0.1

clearInterval описан в разделе таймеры.

clearTimeout(timeoutObject)

Добавлен в: v0.0.1

clearTimeout описан в разделе таймеры.

console

Добавлен в: v0.1.100
  • <Объект>

Используется для вывода в stdout и stderr. Смотрите раздел console.

Event

История
Версия Изменения
v15.4.0

Больше не экспериментальный.

v15.0.0

Добавлен в: v15.0.0

Браузерная реализация класса Event. См. EventTarget и Event API для получения более подробной информации.

EventTarget

История
Версия Изменения
v15.4.0

Больше не экспериментальный.

v15.0.0

Добавлен в: v15.0.0

Браузерная реализация класса EventTarget. См. EventTarget и Event API для получения более подробной информации.

exports

Эта переменная может казаться глобальной, но таковой не является. См. exports.

global

Добавлен в: v0.1.27
  • <Объект> Объект глобального пространства имён.

В браузерах область верхнего уровня — глобальная область. Это означает, что в браузере var something будет определять новую глобальную переменную. В Node.js это отличается. Область верхнего уровня не является глобальной областью; var something внутри модуля Node.js будет локальным для этого модуля.

MessageChannel

Добавлен в: v15.0.0

Класс MessageChannel. См. MessageChannel для получения более подробной информации.

MessageEvent

Добавлен в: v15.0.0

Класс MessageEvent. См. MessageEvent для получения более подробной информации.

MessagePort

Добавлен в: v15.0.0

Класс MessagePort. См. MessagePort для получения более подробной информации.

module

Эта переменная может казаться глобальной, но таковой не является. См. module.

performance

Объект perf_hooks.performance.

process

Добавлен в: v0.1.7
  • <Объект>

Объект процесса. См. раздел process.

queueMicrotask(callback)

Добавлен в: v11.0.0
  • callback <Функция> Функция для очереди.

Метод queueMicrotask() помещает в очередь микрозадачу вызова callback. Если callback вызовет исключение, будет генерироваться событие 'uncaughtException' объекта process.

Очередь микрозадач управляется V8 и может использоваться аналогично очереди process.nextTick(), которая управляется Node.js. Очередь микрозадач всегда обрабатывается до очереди микрозадач в каждом цикле цикла событий 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);
};

require()

Эта переменная может казаться глобальной, но таковой не является. См. require().

setImmediate(callback[, ...args])

Добавлена в: v0.9.1

setImmediate описана в разделе таймеры.

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

Добавлена в: v0.0.1

setInterval описана в разделе таймеры.

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

Добавлена в: v0.0.1

setTimeout описана в разделе таймеры.

TextDecoder

Добавлена в: v11.0.0

Класс WHATWG TextDecoder. См. раздел TextDecoder.

TextEncoder

Добавлена в: v11.0.0

Класс WHATWG TextEncoder. См. раздел TextEncoder.

URL

Добавлена в: v10.0.0

Класс WHATWG URL. См. раздел URL.

URLSearchParams

Добавлена в: v10.0.0

Класс WHATWG URLSearchParams. См. раздел URLSearchParams.

WebAssembly

Добавлена в: v8.0.0
  • <Объект>

Объект, который служит пространством имён для всей связанной с W3C WebAssembly функциональности. См. Mozilla Developer Network для использования и совместимости.

© 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-v16.x/docs/api/globals.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API