NodeJs 第二章基本内置模块

NodeJs 基本内置模块

• OS
• • EOL
  • arch()``
  • cpus()
  • freeman()
  • homedir()
  • hostname()
  • tmpdir()
• path
• • basename
  • sep
  • delimiter
  • dirname
  • extname
  • join
  • normalize
  • relative
  • resolve
• url
• util
• • callbackify
  • isDeepStrictEqual
  • promisify

OS

模块提供了与操作系统相关的实用方法和属性

EOL

操作系统特定的行尾标记。

• POSIX 上是 \n,
• Windows 上是 \r\n

arch()``

返回为其编译 Node.js 二进制文件的操作系统 CPU 架构。可能的值为 'arm'、'arm64'、'ia32'、'loong64'、'mips'、'mipsel'、'ppc'、'ppc64'、'riscv64'、's390'、's390x' 和 'x64'。

cpus()

返回包含有关每个逻辑 CPU 内核的信息的对象数组。 如果没有可用的 CPU 信息，例如 /proc 文件系统不可用，则该数组将为空。

{
	model: string
	speed: number （以兆赫为单位）
	times {
		user: number // CPU 在用户模式下花费的毫秒数。
		nice: number // CPU 在良好模式下花费的毫秒数。
		sys: number // CPU 在系统模式下花费的毫秒数。
		idle: number // CPU 在空闲模式下花费的毫秒数。
		irq: number // CPU 在中断请求模式下花费的毫秒数。
	}
}

freeman()

以整数形式返回空闲的系统内存量（以字节为单位）。

homedir()

返回当前用户的主目录的字符串路径。

• 在 POSIX 上，它使用 $HOME 环境变量（如果已定义）。 否则它使用 有效的 UID 来查找用户的主目录。
• 在 Windows 上，它使用 USERPROFILE 环境变量（如果已定义）。 否则，它使用当前用户的配置文件目录的路径。

hostname()

以字符串形式返回操作系统的主机名。

tmpdir()

以字符串形式返回操作系统默认的临时文件的目录。

path

提供了用于处理文件和目录的路径的实用工具

basename

方法返回 path 的最后一部分，类似于 Unix basename 命令。 忽略尾随 目录分隔符。

path.basename('/foo/bar/baz/asdf/quux.html');
// Returns: 'quux.html'

path.basename('/foo/bar/baz/asdf/quux.html', '.html');
// Returns: 'quux'

sep

提供特定于平台的路径片段分隔符：

• Windows 上是 \
• POSIX 上是 /

delimiter

提供特定于平台的路径定界符：

• ; 用于 Windows
• : 用于 POSIX

dirname

方法返回 path 的目录名，类似于 Unix dirname 命令。 尾随的目录分隔符被忽略，见 path.sep。

extname

path.extname() 方法返回 path 的扩展名，即 path 的最后一部分中从最后一次出现的 .（句点）字符到字符串的结尾。 如果 path 的最后一部分中没有 .，或者除了 path 的基本名称（参见 path.basename()）的第一个字符之外没有 . 个字符，则返回空字符串。

join

path.join() 方法使用特定于平台的分隔符作为定界符将所有给定的 path 片段连接在一起，然后规范化生成的路径。

零长度的 path 片段被忽略。 如果连接的路径字符串是零长度字符串，则将返回 '.'，表示当前工作目录。

如果任何路径片段不是字符串，则抛出 TypeError。

normalize

方法规范化给定的 path，解析 '...' 和 '.' 片段。

当找到多个连续的路径片段分隔符（例如 POSIX 上的 / 和 Windows 上的 \ 或 /）时，则它们将被平台特定路径片段分隔符（POSIX 上的 / 和 Windows 上的 \）的单个实例替换。 保留尾随的分隔符。

• 如果 path 是零长度字符串，则返回 '.'，表示当前工作目录。

• 如果 path 不是字符串，则抛出 TypeError。

relative

方法根据当前工作目录返回从 from 到 to 的相对路径。 如果 from 和 to 都解析为相同的路径（在分别调用 path.resolve() 之后），则返回零长度字符串。

• 如果零长度字符串作为 from 或 to 传入，则将使用当前工作目录而不是零长度字符串。
• 如果 from 或 to 不是字符串，则抛出 TypeError。

resolve

方法将路径或路径片段的序列解析为绝对路径

• 如果在处理完所有给定的 path 片段之后，还没有生成绝对路径，则使用当前工作目录。
• 生成的路径被规范化，并删除尾部斜杠（除非路径解析为根目录）
• 零长度的 path 片段被忽略。
• 如果没有传入 path 片段，则 path.resolve() 将返回当前工作目录的绝对路径。
• 如果任何参数不是字符串，则抛出 TypeError。

url

提供用于网址处理和解析的实用工具

util

模块支持 Node.js 内部 API 的需求。 许多实用工具对应用和模块开发者也很有用

callbackify

采用 async 函数（或返回 Promise 的函数）并返回遵循错误优先回调风格的函数，即将 (err, value) => ... 回调作为最后一个参数。 在回调中，第一个参数将是拒绝原因（如果 Promise 已解决，则为 null），第二个参数将是已解决的值。

isDeepStrictEqual

如果 val1 和 val2 之间存在深度严格相等，则返回 true。 否则，返回 false。

promisify

采用遵循常见的错误优先的回调风格的函数（也就是将 (err, value) => ... 回调作为最后一个参数），并返回一个返回 promise 的版本。