Перейти к содержанию

Процессы

Процесс запущенного Node.js приложения представлен глобальным объектом process, который является экземпляром класса EventEmitter и предоставляет полные данные о системе, параметрах запуска, переменных окружении и потребялемых процессом ресурсах.

Наиболее часто используемые свойства объекта process:

  • arch - архитектура процессора, на котором запущен Node.js процесс, возможные значения: arm, ia32, x64;
  • argv - массив с параметрами запуска процесса, причем вслед за элементом массива, который содержит параметр, будет элемент со значением этого параметра;
  • connected - булевое значение, значение установленное в true означает, что Node.js процесс был создан с IPC каналом (подробно здесь);
  • env - объект с пользовательским окружением;
  • pid - уникальный идентификатор процесса;
  • platform - платформа операционной системы, возможные значения: freebsd, linux, win32 и т. д.;
  • version - текущая версия Node.js.
console.log('Processor architecture: ', process.arch) // arm | ia32 | x62
console.log('Platform: ', process.platform) //win32 | linux | freebsd

Наиболее часто используемые методы объекта process:

  • cpuUsage() - возвращает объект с пользовательским и системным временем использования процесса в микросекундах, на основе которого можно рассчитать загрузку процессора в процентах, необязательным параметром может принимать свое предыдущее значение;
  • hrtime() - возвращает высоко точное время в виде массива с двумя элементами: секунды и наносекунды;
  • cwd() - возвращает рабочую директорию Node.js процесса;
  • disconnect() - отключает IPC канал от главного процесса и завершает дочерний;
  • exit() - завершает процесс при первой же возможности с заданным кодом (по умолчанию код завершения равен 0);
  • memoryUsage() - возвращает объект с данными об использовании Node.js процессом оперативной памяти, объект содержит свойства rss (отведенный под процесс объем памяти), heapTotal (объем памяти, отведенный под V8), heapUsed (объем памяти, используемый V8 в данный момент) и external (использование памяти объектами C++), все значения в байтах;
  • on() - метод обработки событий;
  • send() - используется для обмена сообщениями между основным и дочерними процессами (подробно здесь);
  • uptime() - возвращает количество миллисекунд, прошедшее с момента запуска процесса.

Пример расчета использования процессом процессора в процентах.

cpu-usage.js

const ns2ms = ns => ns * 1000000

let startTime = process.hrtime()
let startCpuUsage = process.cpuUsage()

for (let i = 0; i < 10000000000; i++);

let diffTime = process.hrtime(startTime)
let diffUsage = process.cpuUsage(startCpuUsage)

let diffTimeMs = diffTime[1] * 1000 + ns2ms(diffTime[1])
let diffUsageUserMs = ns2ms(diffUsage.user)
let diffUsageSystemMS = ns2ms(diffUsage.system)
let cpuUsage = Math.round((100 * (diffUsageUserMs + diffUsageSystemMS)) / diffTimeMs)

console.log('CPU usage, %: ', cpuUsage)

Наиболее часто используемые события объекта process:

  • beforeExit - инициируется, когда полностью заканчивается цикл событий;
  • disconnect - генерируется в дочернем процессе при закрытии канала IPC;
  • exit - инициируется при завершении процесса вызовом метода process.exit() или по завершению цикла событий;
  • message - может возникнуть только в главном процессе, когда в одном из дочерних процессов вызывается метод message();
  • uncaughtException - генерируется в случае возникновения необработанного исключения, но процесс при этом не завершается.

Событие beforeExit не возникнет, если процесс завершается в результате ошибки или вызовом метода process.exit().

Пример обработки uncaughtException.

process.on('uncaughtException', (err, origin) => {
  console.log('Error: ', err)
  console.log('Origin: ', origin)
})

nonExistingFunction()

Коды завершения Node.js процесса:

  • 1 - исключение, которое не обработано ни JavaScript, ни обработчиком события uncaughtException;
  • 3, 4, 10 - означают ошибки исходного кода JavaScript, обычно встречаются только при разработке самой платформы Node.js;
  • 5 - критическая ошибка V8;
  • 6 - необработанное исключение не попало в обработчик критических исключений;
  • 7 - возникновение ошибки в обработчике критических исключений;
  • 9 - используется, если были неправильно заданы аргументы;
  • 12 - возникает в режиме отладки при некорректном указании порта.
process.on('exit', code => console.log(`Exit code: ${code}`))

nonExistingFunction()

В случае завершения цикла событий процесс завершается с кодом 0.

С полным списком свойств, методов и событий Node.js процесса можно ознакомиться на официальном сайте.

В случаях, когда часто выполняются блокирующие основной процесс операции, лучше доверить их выполнение дочерним процессам.