re:re:actable
Урок 022 минуты чтения

Что такое глобальные объекты Node.js?

На этой странице
Кратко

Глобальные объекты Node.js доступны без импорта. К ним относятся globalThis, process, Buffer, таймеры, console, URL, fetch и другие API, которые runtime предоставляет каждому модулю.

Вопрос

Какие глобальные объекты есть в Node.js и чем они отличаются от браузерных?

globalThis

globalThis - стандартный способ обратиться к глобальному объекту в JavaScript.

console.log(globalThis === global); // true в Node.js

В новом коде лучше думать через globalThis, а не завязываться на старое имя global.

Частые глобальные API

APIЗачем нужен
processтекущий процесс
Bufferбинарные данные
consoleвывод в консоль
setTimeoutтаймер
queueMicrotaskmicrotask
URLработа с URL
fetchHTTP-запросы

Не все стоит делать глобальным

Можно добавить свое значение в глобальный объект:

globalThis.appName = 'demo';

Но это почти всегда плохая идея для приложения: появляется скрытая зависимость, сложнее тестировать и понимать порядок инициализации.

Глобальные, но модульные

Многие важные возможности лучше импортировать явно:

import process from 'node:process';
import { Buffer } from 'node:buffer';

Так код становится понятнее и легче анализируется инструментами.

Что важно помнить

  • Универсальный глобальный объект — globalThis; в Node.js есть еще устаревший алиас global.
  • Глобальны process, Buffer, URL, fetch, structuredClone, таймеры.
  • __dirname, require, module — не глобальные, а переменные-обертки модуля CommonJS.
  • Не создавайте собственные глобальные переменные — используйте модули.

Мини-шпаргалка

  • Глобальные объекты доступны без импорта.
  • globalThis - стандартное имя глобального объекта.
  • process и Buffer - важные Node.js-глобалы.
  • Не складывай состояние приложения в globalThis.
  • Явный импорт встроенных модулей часто читабельнее.

Документация

Node.js: Global objects.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам