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 <число> Количество миллисекунд, потраченных процессором в режиме nice.
  • sys <число> Количество миллисекунд, потраченных процессором в режиме 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 если она определена. В противном случае, использует эффективный идентификатор пользователя для поиска домашнего каталога пользователя.

На 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