os.EOL

• <строка>

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

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

os.availableParallelism()

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

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

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

os.arch()

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

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

Значение возврата эквивалентно значению process.arch.

os.constants

• <Объект>

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

os.cpus()

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

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

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

• model <строка>
• speed <число> (в МГц)
• times <объект>
  • user <число> Количество миллисекунд, потраченных процессором в пользовательском режиме.
  • nice <число> Количество миллисекунд, потраченных процессором в режиме повышения приоритета.
  • sys <число> Количество миллисекунд, потраченных процессором в системном режиме.
  • idle <число> Количество миллисекунд, потраченных процессором в режиме ожидания.
  • 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 если она определена. В противном случае используется эффективный 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