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

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

Перечисленные здесь объекты специфичны для 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. См. раздел process object.

require()

• <Функция>

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

require.cache

• <Объект>

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

require.extensions

• <Объект>

Инструкции для require по обработке определенных расширений файлов.

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

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

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

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

require.resolve()

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

setImmediate(callback[, ...args])

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

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

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

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

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