ОС

Модуль os предоставляет ряд утилитных методов, связанных с операционной системой. К нему можно обратиться, используя:

const os = require('os');

os.EOL

• <строка>

Константа строки, определяющая маркер конца строки, специфичный для операционной системы:

• \n в POSIX
• \r\n в Windows

os.arch()[src]

• Возвращает: <строка>

Метод os.arch() возвращает строку, идентифицирующую архитектуру процессора операционной системы, для которой был скомпилирован двоичный файл Node.js.

Возможные значения: 'arm', 'arm64', 'ia32', 'mips', 'mipsel', 'ppc', 'ppc64', 's390', 's390x', 'x32' и 'x64'.

Эквивалентно process.arch.

os.constants

• <Объект>

Возвращает объект, содержащий часто используемые константы, специфичные для операционной системы, для кодов ошибок, сигналов процессов и т. д. Конкретные определённые константы описаны в Константы ОС.

os.cpus()[src]

• Возвращает: <Массив объектов>

Метод os.cpus() возвращает массив объектов, содержащих информацию о каждом логическом ядре процессора.

Свойства каждого объекта включают:

• model <строка>
• speed <число> (в МГц)

• times <объект>

  • user <число> Количество миллисекунд, потраченных процессором в пользовательском режиме.
  • nice <число> Количество миллисекунд, потраченных процессором в режиме nice.
  • sys <число> Количество миллисекунд, потраченных процессором в режиме sys.
  • idle <число> Количество миллисекунд, потраченных процессором в режиме ожидания.
  • irq <число> Количество миллисекунд, потраченных процессором в режиме irq.

[
  {
    model: 'Intel(R) Core(TM) i7 CPU         860  @ 2.80GHz',
    speed: 2926,
    times: {
      user: 252020,
      nice: 0,
      sys: 30340,
      idle: 1070356870,
      irq: 0
    }
  },
  {
    model: 'Intel(R) Core(TM) i7 CPU         860  @ 2.80GHz',
    speed: 2926,
    times: {
      user: 306960,
      nice: 0,
      sys: 26980,
      idle: 1071569080,
      irq: 0
    }
  },
  {
    model: 'Intel(R) Core(TM) i7 CPU         860  @ 2.80GHz',
    speed: 2926,
    times: {
      user: 248450,
      nice: 0,
      sys: 21750,
      idle: 1070919370,
      irq: 0
    }
  },
  {
    model: 'Intel(R) Core(TM) i7 CPU         860  @ 2.80GHz',
    speed: 2926,
    times: {
      user: 256880,
      nice: 0,
      sys: 19430,
      idle: 1070905480,
      irq: 20
    }
  },
  {
    model: 'Intel(R) Core(TM) i7 CPU         860  @ 2.80GHz',
    speed: 2926,
    times: {
      user: 511580,
      nice: 20,
      sys: 40900,
      idle: 1070842510,
      irq: 0
    }
  },
  {
    model: 'Intel(R) Core(TM) i7 CPU         860  @ 2.80GHz',
    speed: 2926,
    times: {
      user: 291660,
      nice: 0,
      sys: 34360,
      idle: 1070888000,
      irq: 10
    }
  },
  {
    model: 'Intel(R) Core(TM) i7 CPU         860  @ 2.80GHz',
    speed: 2926,
    times: {
      user: 308260,
      nice: 0,
      sys: 55410,
      idle: 1071129970,
      irq: 880
    }
  },
  {
    model: 'Intel(R) Core(TM) i7 CPU         860  @ 2.80GHz',
    speed: 2926,
    times: {
      user: 266450,
      nice: 1480,
      sys: 34920,
      idle: 1072572010,
      irq: 30
    }
  }
]

Поскольку значения nice специфичны для UNIX, в Windows значения nice всех процессоров всегда равны 0.

os.endianness()[src]

• Возвращает: <строка>

Метод os.endianness() возвращает строку, определяющую порядок байтов процессора для которого был скомпилирован двоичный файл Node.js.

Возможные значения:

• 'BE' для big endian
• 'LE' для little endian.

os.freemem()

• Возвращает: <целое>

Метод os.freemem() возвращает количество свободной оперативной памяти в байтах в виде целого числа.

os.getPriority([pid])[src]

• pid <целое> Идентификатор процесса для получения приоритета планирования. По умолчанию 0.
• Возвращает: <целое>

Метод os.getPriority() возвращает приоритет планирования для процесса, указанного с помощью pid. Если pid не указано или равно 0, возвращается приоритет текущего процесса.

os.homedir()

• Возвращает: <строка>

Метод os.homedir() возвращает домашний каталог текущего пользователя в виде строки.

os.hostname()

• Возвращает: <строка>

Метод os.hostname() возвращает имя хоста операционной системы в виде строки.

os.loadavg()[src]

• Возвращает: <массив чисел>

Метод os.loadavg() возвращает массив, содержащий средние значения нагрузки за 1, 5 и 15 минут.

Среднее значение нагрузки — это мера активности системы, вычисленная операционной системой и выраженная дробным числом. Как правило, среднее значение нагрузки должно быть меньше количества логических процессоров в системе.

Среднее значение нагрузки — это понятие, специфичное для UNIX, и не имеет прямого аналога в платформах Windows. В Windows возвращаемое значение всегда равно [0, 0, 0].

os.networkInterfaces()[src]

• Возвращает: <объект>

Метод os.networkInterfaces() возвращает объект, содержащий только сетевые интерфейсы, которым был назначен сетевой адрес.

Каждый ключ в возвращаемом объекте идентифицирует сетевой интерфейс. Соответствующее значение является массивом объектов, каждый из которых описывает назначенный сетевой адрес.

Свойства назначенного сетевого адреса включают:

• address <строка> Назначенный IPv4 или IPv6 адрес
• netmask <строка> Маска сети IPv4 или IPv6
• family <строка> Либо IPv4, либо IPv6
• mac <строка> MAC-адрес сетевого интерфейса
• internal <булево> true, если сетевой интерфейс является локальным или аналогичным интерфейсом, который недоступен удаленно; в противном случае false
• scopeid <число> Численный идентификатор области видимости IPv6 (указывается только когда family — IPv6)
• cidr <строка> Назначенный IPv4 или IPv6 адрес с префиксом маршрутизации в нотации CIDR. Если netmask недействителен, это свойство устанавливается в null.

{
  lo: [
    {
      address: '127.0.0.1',
      netmask: '255.0.0.0',
      family: 'IPv4',
      mac: '00:00:00:00:00:00',
      internal: true,
      cidr: '127.0.0.1/8'
    },
    {
      address: '::1',
      netmask: 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff',
      family: 'IPv6',
      mac: '00:00:00:00:00:00',
      scopeid: 0,
      internal: true,
      cidr: '::1/128'
    }
  ],
  eth0: [
    {
      address: '192.168.1.108',
      netmask: '255.255.255.0',
      family: 'IPv4',
      mac: '01:02:03:0a:0b:0c',
      internal: false,
      cidr: '192.168.1.108/24'
    },
    {
      address: 'fe80::a00:27ff:fe4e:66a1',
      netmask: 'ffff:ffff:ffff:ffff::',
      family: 'IPv6',
      mac: '01:02:03:0a:0b:0c',
      scopeid: 1,
      internal: false,
      cidr: 'fe80::a00:27ff:fe4e:66a1/64'
    }
  ]
}

os.platform()[src]

• Возвращает: <строка>

Метод os.platform() возвращает строку, определяющую платформу операционной системы, установленную во время компиляции Node.js.

Возможные значения:

• 'aix'
• 'darwin'
• 'freebsd'
• 'linux'
• 'openbsd'
• 'sunos'
• 'win32'

Эквивалентно process.platform.

Значение 'android' также может быть возвращено, если Node.js построен на операционной системе Android. Однако поддержка Android в Node.js в настоящее время считается экспериментальной.

os.release()

• Возвращает: <строка>

Метод os.release() возвращает строку, идентифицирующую выпуск операционной системы.

В системах POSIX выпуск операционной системы определяется вызовом uname(3). В Windows используется GetVersionExW(). Дополнительная информация доступна по адресу https://en.wikipedia.org/wiki/Uname#Examples.

os.setPriority([pid, ]priority)[src]

• pid <целое> Идентификатор процесса, для которого необходимо установить приоритет планирования. По умолчанию 0.
• priority <целое> Приоритет планирования, который необходимо назначить процессу.

Метод os.setPriority() пытается установить приоритет планирования для процесса, указанного параметром pid. Если параметр pid не указан или равен 0, используется приоритет текущего процесса.

Входной параметр priority должен быть целым числом в диапазоне от -20 (высокий приоритет) до 19 (низкий приоритет). Из-за различий между уровнями приоритета Unix и классами приоритетов Windows, priority сопоставляется с одним из шести констант приоритета в os.constants.priority. При получении уровня приоритета процесса этот диапазон сопоставлений может привести к несколько отличающемуся возвращаемому значению в Windows. Чтобы избежать путаницы, рекомендуется задавать priority равным одной из констант приоритета.

В Windows, для установки приоритета на PRIORITY_HIGHEST требуется повышенный уровень доступа, в противном случае приоритет будет тихо понижен до PRIORITY_HIGH.

os.tmpdir()[src]

• Возвращает: <строка>

Метод os.tmpdir() возвращает строку, указывающую на стандартный каталог операционной системы для временных файлов.

os.totalmem()

• Возвращает: <целое>

Метод os.totalmem() возвращает общее количество оперативной памяти в байтах как целое число.

os.type()

• Возвращает: <строка>

Метод os.type() возвращает строку, идентифицирующую имя операционной системы, как возвращает uname(3). Например, 'Linux' в Linux, 'Darwin' в macOS и 'Windows_NT' в Windows.

Дополнительную информацию о выводе команды uname(3) на различных операционных системах можно найти по адресу https://en.wikipedia.org/wiki/Uname#Examples.

os.uptime()

• Возвращает: <целое>

Метод os.uptime() возвращает время работы системы в секундах.

os.userInfo([options])[src]

• options <Объект>

  • encoding <строка> Кодировка символов, используемая для интерпретации результирующих строк. Если encoding установлено в 'buffer', значения username, shell и homedir будут Buffer экземплярами. По умолчанию: 'utf8'.
• Возвращает: <Объект>

Метод os.userInfo() возвращает информацию об активном пользователе — в системах POSIX это обычно подмножество файла паролей. Возвращаемый объект содержит поля username, uid, gid, shell и homedir. В Windows поля uid и gid являются -1, а поле shell имеет значение null.

Значение homedir, возвращаемое методом os.userInfo(), предоставляется операционной системой. Это отличается от результата os.homedir(), который запрашивает несколько переменных среды для домашнего каталога, прежде чем перейти к ответу операционной системы.

Константы OS

Следующие константы экспортируются методом os.constants.

Не все константы доступны на каждой операционной системе.

Константы сигналов

Следующие константы сигналов экспортируются методом os.constants.signals:

Постоянные значения ошибок

Следующие постоянные значения ошибок экспортируются os.constants.errno:

Постоянные значения ошибок POSIX

Постоянные значения ошибок, специфичные для Windows

Следующие коды ошибок специфичны для операционной системы Windows:

Постоянные dlopen

Если доступны на операционной системе, следующие постоянные экспортируются в os.constants.dlopen. Подробную информацию см. в dlopen(3).

Постоянные приоритета

Следующие постоянные значения планирования процессов экспортируются os.constants.priority:

Постоянные libuv