ОС

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

const os = require('os');

os.EOL

• <строка>

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

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

os.arch()

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

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

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

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

os.constants

• <Объект>

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

os.cpus()

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

Метод 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()

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

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

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

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

os.freemem()

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

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

os.homedir()

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

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

os.hostname()

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

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

os.loadavg()

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

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

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

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

os.networkInterfaces()

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

Метод 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',
      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',
      internal: false,
      cidr: 'fe80::a00:27ff:fe4e:66a1/64'
    }
  ]
}

os.platform()

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

Метод 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.tmpdir()

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

Метод 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() возвращает время активности системы в секундах.

Примечание: В Windows возвращаемое значение включает дробные доли секунды. Используйте Math.floor() для получения целых секунд.

os.userInfo([options])

• 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.constants.

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

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

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

Константы ошибок

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

Константы ошибок POSIX

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

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

Постоянные libuv