os.EOL

• <string>

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

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

os.availableParallelism()

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

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

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

os.arch()

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

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

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

os.constants

• <Object>

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

os.cpus()

• Возвращает: <Object[]>

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

Каждый объект содержит следующие свойства:

• model <string>
• speed <number> (в МГц)
• times <Object>
  • user <number> Количество миллисекунд, в течение которых процессор работал в пользовательском режиме.
  • nice <number> Количество миллисекунд, в течение которых процессор работал в режиме nice.
  • sys <number> Количество миллисекунд, в течение которых процессор работал в системном режиме.
  • idle <number> Количество миллисекунд, в течение которых процессор находился в режиме ожидания.
  • irq <number> Количество миллисекунд, в течение которых процессор работал в режиме обработки прерываний.

[
  {
    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

• <string>

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

• \\.\nul в Windows
• /dev/null в POSIX

os.endianness()

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

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

Возможные значения: 'BE' для прямого порядка байтов и 'LE' для обратного порядка байтов.

os.freemem()

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

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

os.getPriority([pid])

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

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

os.homedir()

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

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

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

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

os.hostname()

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

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

os.loadavg()

• Возвращает: <number[]>

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

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

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

os.machine()

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

Возвращает тип компьютера в виде строки, например 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()

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

Возвращает объект с сетевыми интерфейсами, которым назначен сетевой адрес.

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

Объект назначенного сетевого адреса содержит следующие свойства:

• address <string> Назначенный адрес IPv4 или IPv6
• netmask <string> Сетевая маска IPv4 или IPv6
• family <string> Либо IPv4, либо IPv6
• mac <string> MAC-адрес сетевого интерфейса
• internal <boolean> true, если сетевой интерфейс является loopback-интерфейсом или аналогичным интерфейсом, недоступным извне; в противном случае — false
• scopeid <number> Числовой идентификатор области IPv6 (указывается только если family равно IPv6)
• cidr <string> Назначенный адрес 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()

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

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

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

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

os.release()

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

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

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

os.setPriority([pid, ]priority)

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

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

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

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

os.tmpdir()

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

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

В Windows результат может быть переопределён переменными окружения TEMP и TMP, причём TEMP имеет приоритет над TMP. Если ни одна из них не задана, по умолчанию используется %SystemRoot%\temp или %windir%\temp.

В системах, отличных от Windows, для переопределения результата этого метода проверяются переменные окружения TMPDIR, TMP и TEMP в указанном порядке. Если ни одна из них не задана, по умолчанию используется /tmp.

В некоторых дистрибутивах операционных систем значение TMPDIR (не Windows) либо TEMP и TMP (Windows) задаётся по умолчанию без дополнительной настройки системными администраторами. Результат os.tmpdir() обычно отражает системные предпочтения, если пользователь явно не переопределил его.

os.totalmem()

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

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

os.type()

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

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

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

os.uptime()

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

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

os.userInfo([options])

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

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

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

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

os.version()

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

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

В 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