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

Эти объекты доступны во всех модулях. Некоторые из этих объектов фактически не находятся в глобальной области видимости, а в области видимости модуля — это будет отмечено.

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

Класс: Buffer

• <Функция>

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

__dirname

• <Строка>

Имя каталога текущего модуля. Это то же самое, что и path.dirname() файла __filename.

__dirname фактически не является глобальным, а локальным для каждого модуля.

Пример: запуск node example.js из /Users/mjr

console.log(__dirname);
// Prints: /Users/mjr
console.log(path.dirname(__filename));
// Prints: /Users/mjr

__filename

• <Строка>

Имя файла текущего модуля. Это разрешённый абсолютный путь к файлу текущего модуля.

Для основной программы это не обязательно совпадает с именем файла, используемым в командной строке.

См. __dirname для имени каталога текущего модуля.

__filename фактически не является глобальным, а локальным для каждого модуля.

Примеры:

Запуск node example.js из /Users/mjr

console.log(__filename);
// Prints: /Users/mjr/example.js
console.log(__dirname);
// Prints: /Users/mjr

Рассмотрим два модуля: a и b, где b является зависимостью от a и есть структура каталогов:

• /Users/mjr/app/a.js
• /Users/mjr/app/node_modules/b/b.js

Ссылки на __filename внутри b.js вернут /Users/mjr/app/node_modules/b/b.js, а ссылки на __filename внутри a.js вернут /Users/mjr/app/a.js.

clearImmediate(immediateObject)

clearImmediate описан в разделе timers.

clearInterval(intervalObject)

clearInterval описан в разделе timers.

clearTimeout(timeoutObject)

clearTimeout описан в разделе timers.

console

• <Объект>

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

exports

Ссылка на module.exports для краткого набора. Подробности о том, когда использовать exports и module.exports, см. в документации по системе модулей.

exports фактически не является глобальным, а локальным для каждого модуля.

См. документацию по системе модулей для получения дополнительной информации.

global

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

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

module

• <Объект>

Ссылка на текущий модуль. В частности, module.exports используется для определения того, что экспортирует модуль, и что доступно через require().

module фактически не является глобальным, а локальным для каждого модуля.

См. документацию по системе модулей для получения дополнительной информации.

process

• <Объект>

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

require()

• <Функция>

Для загрузки модулей. См. раздел Модули. require фактически не является глобальным, а локальным для каждого модуля.

require.cache

• <Объект>

Модули кэшируются в этом объекте при их загрузке. Удаление пары ключ-значение из этого объекта заставит следующую require перезагрузить модуль. Обратите внимание, что это не относится к нативным дополнениям, для которых перезагрузка приведёт к ошибке.

require.extensions

• <Объект>

Указывает require как обрабатывать определённые расширения файлов.

Обработка файлов с расширением .sjs как .js:

require.extensions['.sjs'] = require.extensions['.js'];

Устарело Раньше этот список использовался для загрузки модулей, не являющихся JavaScript, в Node.js путём компиляции их по запросу. Однако на практике существуют гораздо лучшие способы, например, загрузка модулей с помощью другой программы Node.js или предварительная компиляция в JavaScript.

Поскольку система модулей заблокирована, эта функция, вероятно, никогда не исчезнет. Однако она может содержать скрытые ошибки и сложности, которые лучше оставить без изменений.

require.resolve()

Используйте внутренний механизм require() для поиска местоположения модуля, но вместо загрузки модуля верните только резолвированный путь к файлу.

setImmediate(callback[, arg][, ...])

setImmediate описан в разделе timers.

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

setInterval описан в разделе timers.

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

setTimeout описан в разделе timers.