OS

• os.EOL
• os.arch()
• os.constants
• os.cpus()
• os.endianness()
• os.freemem()
• os.homedir()
• os.hostname()
• os.loadavg()
• os.networkInterfaces()
• os.platform()
• os.release()
• os.tmpdir()
• os.totalmem()
• os.type()
• os.uptime()
• os.userInfo([options])
• Константы ОС
  • Константы сигналов
  • Константы ошибок
    • Константы ошибок POSIX
    • Константы ошибок для Windows
  • Константы libuv

Стабильность: 2 – Стабильная

Модуль os предоставляет набор операционных системных методов. Его можно вызвать так:

const os = require('os');

os.EOL

• <Строка>

Строковая константа, определяющая маркер конца текущей строки:

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

os. arch()

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

Текущие возможные значения:

Равнозначно process.arch.

os.constants

• <Объект>

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

os.cpus()

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

Метод os.cpus() возвращает массив объектов, которые содержат информацию про каждый установленное ядро/CPU.

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

• model <Строка>
• speed <число> (в МГц)
• times <объект>
  • user <число> Число миллисекунд, которые CPU провел в пользовательском режиме
  • nice <число> Число миллисекунд, которые CPU провел в nice режиме.
  • sys <число> Число миллисекунд, которые CPU провел в sys режиме.
  • Idle <число> Число миллисекунд, которые CPU провел в idle режиме.
  • Irq <число> Число миллисекунд, которые CPU провел в 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() возвращает строку, определяющую порядок байт CPU для которого скомпилирован бинарный Node.js.

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

• ‘BE’ для большого эндиана
• ‘LE’ для малого эндиана

os.freemem()

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

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

os.homedir()

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

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

os.hostname()

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

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

os.loadavg()

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

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

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

Средняя нагрузка является исключительно UNIX-овым концептом и не имеет реальных аналогов на Windows. На Windows данный метод всегда будет возвращать значения [0, 0, 0].

os.networkInterfaces()

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

Метод os.networkInterfaces() возвращает объект, содержащий только сетевые интерфейсы, которые были назначены на адрес сети.

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

Свойства, доступные для назначенного объекта адреса сети, включают:

• address <Строка> Назначенный адрес IPv4 или IPv6
• netmask <Строка> Сетевая маска IPv4 или IPv6
• family <Строка> IPv4или IPv6
• mac <Строка> MAC-адрес сетевого интерфейса
• internal <boolean> true, если сетевой интерфейс является замкнутым либо недоступным удаленно, во всех прочих случаях false
• scopeid <число> IDокружения для 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.plaform() возвращает строку, показывающущю, какая платформа ОС была установлена во время компиляции Node.js.

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

• 'aix'
• 'darwin'
• 'freebsd'
• 'linux'
• 'openbsd'
• 'sunos'
• 'win32'

Является эквивалентом process.platform.

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

os.release()

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

Метод os.release() возвращает строку, показывающую релиз операционной системы.

Примечание: на системах POSIX релиз ОСопределяется вызовом uname(3). На Windows используют GetVersionExW().

os.tmpdir()

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

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

os.totalmem()

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

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

os.type()

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

Метод os.type() возвращает строку, показывающую имя операционной системы, возвращенное uname(3). Например, ‘Linux’ на Linux, ‘Darwin’ на OS X и ‘Windows_NT’ на Windows.

Больше информации про запуск uname на разных операционных системах на https://en.wikipedia.org/wiki/Uname#Examples

os.uptime()

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

Метод os.uptime() возвращает время безотказной работы системы в секундах.

Примечание: по меркам целых значений Node.js, данное число представлено как double. Однако, дробные секунды не могут быть возвращены и данное значение обычно принимается как целое.

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