ОС

Модуль 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)

{
  lo: [
    {
      address: '127.0.0.1',
      netmask: '255.0.0.0',
      family: 'IPv4',
      mac: '00:00:00:00:00:00',
      internal: true
    },
    {
      address: '::1',
      netmask: 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff',
      family: 'IPv6',
      mac: '00:00:00:00:00:00',
      internal: true
    }
  ],
  eth0: [
    {
      address: '192.168.1.108',
      netmask: '255.255.255.0',
      family: 'IPv4',
      mac: '01:02:03:0a:0b:0c',
      internal: false
    },
    {
      address: 'fe80::a00:27ff:fe4e:66a1',
      netmask: 'ffff:ffff:ffff:ffff::',
      family: 'IPv6',
      mac: '01:02:03:0a:0b:0c',
      internal: false
    }
  ]
}

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.

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

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 Specific Error Constants

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

libuv Constants