Операционная система¶

v18.x.x

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

1

const os = require('node:os');

os.EOL¶

• <string>

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

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

os.availableParallelism()¶

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

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

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

os.arch()¶

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

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

Возвращаемое значение эквивалентно process.arch.

os.constants¶

• <Object>

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

os.cpus()¶

• Возвращает: {Object[]}

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

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

• модель <string>
• скорость <number> (в МГц)
• times <Object>
  • user <number> Количество миллисекунд, проведенных процессором в пользовательском режиме.
  • nice <number> Количество миллисекунд, проведенных процессором в приятном режиме.
  • sys <number> Количество миллисекунд, проведенных процессором в режиме sys.
  • idle <number> Количество миллисекунд, проведенных процессором в режиме простоя.
  • irq <number> Количество миллисекунд, проведенных процессором в режиме irq.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

[
    {
        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,
        },
    },
];

Значения nice относятся только к POSIX. В Windows значения nice для всех процессоров всегда равны 0.

os.cpus().length не следует использовать для вычисления количества параллелизма, доступного приложению. Для этой цели используйте os.availableParallelism().

os.devNull¶

• <string>

Путь к файлу нулевого устройства в зависимости от платформы.

• \.\nul в Windows
• /dev/null на POSIX

os.endianness()¶

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

Возвращает строку, определяющую эндианальность процессора, для которого был скомпилирован двоичный файл Node.js.

Возможные значения: 'BE' для big endian и 'LE' для little endian.

os.freemem()¶

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

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

os.getPriority([pid])¶

• pid <integer> Идентификатор процесса для получения приоритета планирования. По умолчанию: 0.
• Возвращает: <integer>

Возвращает приоритет планирования для процесса, указанного pid. Если pid не указан или равен 0, возвращается приоритет текущего процесса.

os.homedir()¶

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

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

На POSIX используется переменная окружения $HOME, если она определена. В противном случае используется эффективный UID для поиска домашнего каталога пользователя.

В Windows используется переменная окружения USERPROFILE, если она определена. В противном случае используется путь к каталогу профиля текущего пользователя.

os.hostname()¶

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

Возвращает имя хоста операционной системы в виде строки.

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()¶

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

Возвращает объект, содержащий сетевые интерфейсы, которым был присвоен сетевой адрес.

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

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

• address <string> Назначенный адрес IPv4 или IPv6.
• netmask <string> Маска сети IPv4 или IPv6
• family <string> либо IPv4, либо IPv6.
• mac <string> MAC-адрес сетевого интерфейса
• internal <boolean> true, если сетевой интерфейс является loopback или подобным интерфейсом, к которому нет удаленного доступа; иначе false.
• scopeid <number> Числовой идентификатор области действия IPv6 (указывается только в том случае, если family - IPv6)
• cidr <string> Назначенный IPv4 или IPv6 адрес с префиксом маршрутизации в нотации CIDR. Если netmask недействительна, это свойство устанавливается в null.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

{
  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'
    }
  ]
}

os.platform()¶

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

Возвращает строку, идентифицирующую платформу операционной системы, для которой был скомпилирован двоичный файл Node.js. Значение устанавливается во время компиляции. Возможные значения: 'aix', 'darwin', 'freebsd', 'linux', 'openbsd', 'sunos', и 'win32'.

Возвращаемое значение эквивалентно process.platform.

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

os.release()¶

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

Возвращает операционную систему в виде строки.

В POSIX системах выпуск операционной системы определяется вызовом uname(3). В Windows используется GetVersionExW(). Дополнительную информацию см. на https://en.wikipedia.org/wiki/Uname#Examples.

os.setPriority([pid, ]priority)¶

• pid <integer> Идентификатор процесса, для которого нужно установить приоритет планирования. По умолчанию: 0.
• priority <integer> Приоритет планирования, который нужно назначить процессу.

Пытается установить приоритет планирования для процесса, указанного pid. Если pid не указан или равен 0, используется идентификатор текущего процесса.

Входное значение priority должно быть целым числом между -20 (высокий приоритет) и 19 (низкий приоритет). Из-за различий между уровнями приоритетов Unix и классами приоритетов Windows, priority отображается на одну из шести констант приоритетов в os.constants.priority. При извлечении уровня приоритета процесса это сопоставление диапазонов может привести к тому, что возвращаемое значение будет немного отличаться в Windows. Чтобы избежать путаницы, установите priority в одну из констант приоритета.

В Windows установка приоритета в PRIORITY_HIGHEST требует повышенных привилегий пользователя. В противном случае установленный приоритет будет молча снижен до PRIORITY_HIGH.

os.tmpdir()¶

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

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

os.totalmem()¶

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

Возвращает общий объем системной памяти в байтах в виде целого числа.

os.type()¶

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

Возвращает имя операционной системы, полученное с помощью uname(3). Например, возвращается 'Linux' в Linux, 'Darwin' в macOS и 'Windows_NT' в Windows.

Дополнительную информацию о результатах выполнения uname(3) в различных операционных системах см. в https://en.wikipedia.org/wiki/Uname#Examples.

os.uptime()¶

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

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

os.userInfo([options])¶

• options <Object>
  • encoding <string> Кодировка символов, используемая для интерпретации результирующих строк. Если encoding имеет значение 'buffer', значения username, hell и homedir будут экземплярами Buffer. По умолчанию: 'utf8'.
• Возвращает: <Object>

Возвращает информацию о текущем действующем пользователе. На POSIX платформах это обычно подмножество файла паролей. Возвращаемый объект включает в себя username, uid, gid, hell и homedir. В Windows поля uid и gid равны -1, а shell - null.

Значение homedir, возвращаемое os.userInfo(), предоставляется операционной системой. Это отличается от результата os.homedir(), который запрашивает переменные окружения для домашнего каталога, прежде чем вернуться к ответу операционной системы.

Выбрасывает SystemError, если у пользователя нет имени пользователя или homedir.

os.version()¶

• Возвращает {строку}

Возвращает строку, идентифицирующую версию ядра.

В POSIX системах выпуск операционной системы определяется вызовом uname(3). В Windows используется RtlGetVersion(), а если она недоступна, то используется GetVersionExW(). Дополнительную информацию см. в https://en.wikipedia.org/wiki/Uname#Examples.

Константы ОС¶

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

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

Signal constants¶

The following signal constants are exported by os.constants.signals.

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

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

POSIX error constants¶

Windows-specific error constants¶

The following error codes are specific to the Windows operating system.

константы dlopen¶

Если они доступны в операционной системе, следующие константы экспортируются в os.constants.dlopen. Подробную информацию см. в разделе dlopen(3).

Константы приоритетов¶

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

libuv constants¶