os.EOL

• <строка>

Маркер конца строки, специфичный для операционной системы.

• \n на POSIX
• \r\n на Windows

os.availableParallelism()

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

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

Эта функция является небольшим обёрткой вокруг uv_available_parallelism() из libuv.

os.arch()

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

Возвращает архитектуру процессора операционной системы, для которой скомпилирован бинарный файл Node.js. Возможные значения: 'arm', 'arm64', 'ia32', 'mips', 'mipsel', 'ppc', 'ppc64', 's390', 's390x', и 'x64'.

Возвращаемое значение эквивалентно process.arch.

os.constants

• <Объект>

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

os.cpus()

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

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

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

• 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,
    },
  },
] copy

nice значения доступны только на POSIX. На Windows значения nice всех процессоров всегда равны 0.

os.cpus().length не следует использовать для расчёта доступного параллелизма для приложения. Для этой цели используйте os.availableParallelism().

os.devNull

• <строка>

Путь к файлу устройства null, специфичный для платформы.

• \\.\nul на Windows
• /dev/null на POSIX

os.endianness()

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

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

Возможные значения: 'BE' для big endian и 'LE' для little endian.

os.freemem()

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

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

os.getPriority([pid])

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

Возвращает приоритет планирования процесса, заданного pid. Если pid не указан или равен 0, возвращается приоритет текущего процесса.

os.homedir()

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

Возвращает путь к домашнему каталогу текущего пользователя.

На POSIX, если определена переменная среды $HOME, она используется. В противном случае используется эффективный идентификатор пользователя (effective UID) для поиска домашнего каталога.

На Windows, если определена переменная среды USERPROFILE, она используется. В противном случае используется путь к профилю текущего пользователя.

os.hostname()

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

Возвращает имя хоста операционной системы в виде строки.

os.loadavg()

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

Возвращает массив, содержащий среднее время загрузки за 1, 5 и 15 минут.

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

Среднее время загрузки - понятие, специфичное для Unix. На Windows возвращаемое значение всегда [0, 0, 0].

os.machine()

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

Возвращает тип машины в виде строки, например arm, arm64, aarch64, mips, mips64, ppc64, ppc64le, s390, s390x, i386, i686, x86_64.

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

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'
    }
  ]
} copy

os.platform()

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

Возвращает строку, определяющую платформу операционной системы, для которой был скомпилирован двоичный файл Node.js. Значение устанавливается во время компиляции. Возможные значения — 'aix', 'darwin', 'freebsd', 'linux', 'openbsd', 'sunos', и 'win32'.

Возвращаемое значение эквивалентно process.platform.

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

os.release()

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

Возвращает операционную систему в виде строки.

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

os.setPriority([pid, ]priority)

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

Попытка установить приоритет планирования для процесса, заданного pid. Если pid не предоставлено или равно 0, используется идентификатор процесса текущего процесса.

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

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

os.tmpdir()

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

Возвращает системный каталог по умолчанию для временных файлов в виде строки.

os.totalmem()

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

Возвращает общий объём системной памяти в байтах как целое число.

os.type()

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

Возвращает имя операционной системы, возвращённое uname(3). Например, возвращает 'Linux' в Linux, 'Darwin' в macOS и 'Windows_NT' в Windows.

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

os.uptime()

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

Возвращает время работы системы в секундах.

os.userInfo([options])

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

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

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

Выбрасывает SystemError, если у пользователя нет username или homedir.

os.version()

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

Возвращает строку, определяющую версию ядра.

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

Постоянные значения ОС

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

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

Постоянные значения сигналов

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

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

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

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

Ошибки, специфичные для Windows

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

Константы dlopen

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

Константы приоритета

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

Константы libuv