OS （操作系统）

稳定性: 2 - 稳定的
os 模块提供了一些操作系统相关的实用方法。可以这么引用它:

const os = require('os');

os.EOL

新增于: v0.7.8

• <string>

一个字符串常量,定义操作系统相关的行末标志:

• \n 在 POSIX 系统上
• \r\n 在 Windows系统上

os.arch()

新增于: v0.5.0

• 返回: <string>

os.arch()方法返回一个字符串, 表明Node.js 二进制编译 所用的 操作系统CPU架构.

现在可能的值有: 'arm', 'arm64', 'ia32', 'mips', 'mipsel', 'ppc', 'ppc64', 's390', 's390x', 'x32', 'x64', 和 'x86'.

等价于 process.arch.

os.constants

新增于: v6.3.0

• <Object>

返回一个包含错误码,处理信号等通用的操作系统特定常量的对象. 现在, 这些特定的常量的定义被描述在OS Constants.

os.cpus()

新增于: v0.3.3

• Returns: <Array>

os.cpus() 方法返回一个对象数组, 包含安装的每个CPU/CPU核的信息.

下面的属性包含在每个对象中:

• model <string>
• speed <number> (兆赫兹为单位)
• times <Object>
  • user <number> CPU花费在用户模式下的毫秒时间数.
  • nice <number> CPU花费在良好模式下的毫秒时间数.
  • sys <number> CPU花费在系统模式下的毫秒时间数.
  • idle <number> CPU花费在空闲模式下的毫秒时间数.
  • irq <number> CPU花费在中断请求模式下的毫秒时间数.

For example:

[
  {
    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()

新增于: v0.9.4

• Returns: <string>

os.endianness()方法返回一个字符串,表明Node.js二进制编译环境的字节顺序.

可能的值:

• 'BE' 大端模式
• 'LE' 小端模式

os.freemem()

新增于: v0.3.3

• Returns: <integer>

os.freemem() 方法以整数的形式回空闲系统内存 的字节数.

os.homedir()

新增于: v2.3.0

• Returns: <string>

os.homedir() 方法以字符串的形式返回当前用户的home目录.

os.hostname()

新增于: v0.3.3

• Returns: <string>

os.hostname()方法以字符串的形式返回操作系统的主机名.

os.loadavg()

新增于: v0.3.3

• Returns: <Array>

os.loadavg()方法返回一个数组,包含1, 5, 15分钟平均负载.

平均负载是系统活动的测量,由操作系统计算得出,表达为一个分数. 一般来说,平均负载应该理想地比系统的逻辑CPU的数目要少. 平均负载是UNIX相关的概念,在Windows平台上没有对应的概念. 在Windows上,其返回值总是[0, 0, 0].

os.networkInterfaces()

新增于: v0.6.0

• Returns: <Object>

os.networkInterfaces()方法返回一个对象,包含只有被赋予网络地址的网络接口.

在返回对象的每个关键词都指明了一个网络接口.

返回的值是一个对象数组, 每个都描述了赋予的网络地址.

被赋予网络地址的对象包含的属性:

• address <string> 被赋予的 IPv4 或 IPv6 地址
• netmask <string> IPv4 或 IPv6 子网掩码
• family <string> IPv4 或 IPv6
• mac <string> 网络接口的MAC地址
• internal <boolean> 如果 网络接口是loopback或相似的远程不能用的接口时, 值为true,否则为false
• scopeid <number> 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()

新增于: v0.5.0

• Returns: <string>

os.platform() 方法返回一个字符串, 指定Node.js编译时的操作系统平台

当前可能的值有:

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

等价于 process.platform.

注意: 如果Node.js 在Android操作系统上构建, 'android'值 可能被返回. 然而, Android支持Node.js在当前被认为是实验期.

os.release()

新增于: v0.3.3

• Returns: <string>

os.release()方法返回一个字符串, 指定操作系统的发行版.

注意: 在POSIX系统上, 操作系统发行版是通过 调用uname(3)得到的. 在 Windows系统上, 用GetVersionExW() . 请查看 https://en.wikipedia.org/wiki/Uname#Examples 获取更多信息.

os.tmpdir()

版本历史

• Returns: <string>

os.tmpdir()方法返回一个字符串, 表明操作系统的 默认临时文件目录.

os.totalmem()

新增于: v0.3.3

• Returns: <integer>

os.totalmem()方法以整数的形式返回所有系统内存的字节数.

os.type()

新增于: v0.3.3

• Returns: <string>

os.type()方法返回一个字符串,表明操作系统的名字, 由uname(3)返回.举个例子, 'Linux' 在 Linux系统上, 'Darwin' 在 macOS 系统上,'Windows_NT' 在 Windows系统上.

请查看https://en.wikipedia.org/wiki/Uname#Examples 获取其他关于在不同 操作系统上执行uname(3),得到输出的信息.

os.uptime()

新增于: v0.3.3

• Returns: <integer>

os.uptime() 方法在几秒内返回操作系统的上线时间.

Note: On Windows the returned value includes fractions of a second. Use Math.floor() to get whole seconds.

os.userInfo([options])

新增于: v6.0.0

• options <Object>
  • encoding <string> 用于解释结果字符串的字符编码. 如果encoding 被设置为'buffer', username, shell, 和 homedir 的值将成为 Buffer的实例. (默认是: 'utf8')
• Returns: <Object>

os.userInfo()方法当前有效用户的信息 -- 在 POSIX平台上, 这通常是password 文件的子集. 返回的对象包括 username, uid, gid, shell, 和 homedir. 在Windows系统上, uid 和 gid 域是 -1, and shell是 null.

homedir的值由os.userInfo()返回, 由操作系统提供. 这区别了os.homedir()的结果, 它在求助操作系统响应之前, 为home目录请求几个环境变量.

OS 常量

下面的常量被os.constants 所输出.

注意: 并不是所有的常量在每一个操作系统上都是可用的.

信号常量

版本历史

下面的信号常量由 os.constants.signals 给出:

错误常量

下面的错误常量由 os.constants.errno 给出:

POSIX 错误常量

Windows 系统特有的错误常量

下面的错误码与Windows系统相关:

libuv 常量