process（进程）

进程属性

process.title 当前进程标题。为 process.title 分配新值会修改 ps 的当前值。当分配新值时，不同的平台会对标题施加不同的最大长度限制。通常这种限制是相当有限的。例如，在 Linux 和 macOS 上， process.title 仅限于二进制名称的大小加上命令行参数的长度，因为设置 process.title 会覆盖进程的 argv 内存。 Node.js 的 v0.8, 通过覆盖 environ 允许内存较长的过程标题字符串，但是这在一些（相当模糊的）可能是不安全的并且令人困惑情况下。
process.pid 进程的 PIDs
process.ppid 前父进程的 PID
process.env 包含用户环境的对象
process.execArgv 当 Node.js 进程被启动时，Node.js 特定的命令行选项。这些选项在 process.argv 属性返回的数组中不会出现，并且这些选项中不会包括 Node.js 的可执行脚本名称或者任何在脚本名称后面出现的选项。这些选项在创建子进程时是有用的，因为他们包含了与父进程一样的执行环境信息。
process.execPath 启动 Node.js 进程的可执行文件的绝对路径名
process.arch 为其编译 Node.js 二进制文件的操作系统的 CPU 架构。可能的值有：'arm'、 'arm64'、 'ia32'、 'mips'、 'mipsel'、 'ppc'、 'ppc64'、 's390'、 's390x'、 'x32' 和 'x64'。
process.argv 一个包含当启动 Node.js 进程时传入的命令行参数数组。第一个元素是 process.execPath。如果需要访问 argv[0] 的原始值，参见 process.argv0。第二个元素将是正在执行的 JavaScript 文件的路径。其余元素将是任何其他命令行参数。
process.argv0保存当 Node.js 启动时传入的 argv[0] 的原始值的只读副本
process.debugPort Node.js 调试器使用的端口。
process.config 一个包含用于编译当前 Node.js 可执行文件的配置选项的 JavaScript 表示形式Object。process.config 属性值不是只读的，在 Node.js 生态系统中已经有模块扩展、修改或完全替换了 process.config 的值。
process.noDeprecation 是否在当前 Node.js 进程上设置了 --no-deprecation 标志。
process.throwDeprecation process.throwDeprecation 的初始值表明是否在当前的 Node.js 进程上设置了 --throw-deprecation 标志。 process.throwDeprecation 是可变的，因此可以在运行时设置弃用警告是否应该导致错误。
process.allowedNodeEnvironmentFlags process.allowedNodeEnvironmentFlags 属性是 NODE_OPTIONS 环境变量中允许的特殊只读标志的 Set。
process.platform Node.js 进程运行其上的操作系统平台
process.version Node.js 的版本信息s
process.versions 一个对象，此对象列出了Node.js和其依赖的版本信息。 process.versions.modules表明了当前ABI版本，此版本会随着一个C++API变化而增加。如果这些模块使用一个不同ABI版本的模块进行编译，Node.js会拒绝加载模块。
process.release 与当前发布相关的元数据 Object，包括源代码和源代码头文件 tarball 的 URL。包括如下属性：
- name <string> 对于 Node.js，此值始终为 'node'。对于遗留的 io.js 发布包，此值为 'io.js'。
- sourceUrl <string> 指向一个.tar.gz文件的绝对 URL，包括了当前发布的源代码。
- headersUrl<string> 指向一个.tar.gz文件的绝对 URL，包括了当前发布的源代码的头文件信息。这个文件要比全部源代码文件明显小很多，可以用于编译 Node.js 原生插件。
- libUrl <string> 指向一个node.lib文件的绝对 URL，匹配当前发布的结构和版本信息。此文件用于编译 Node.js 本地插件。这个属性只在 Windows 版本中存在，在其他平台中无效。
- lts <string> 标识当前发布的 LTS 标签的字符串。只有 LTS 版本存在这个属性，其他所有版本类型（包括当前版本）这个属性都是 undefined。当前的有效值有：
  - 'Argon' 用于 4.2.0 开始的 4.x LTS 版本。
  - 'Boron' 用于 6.9.0 开始的 6.x LTS 版本。
  - 'Carbon' 用于 8.9.1 开始的 8.x LTS 版本。
process.connected 如果 Node.js 进程是由 IPC 通道的方式创建，则只要 IPC 通道保持连接， process.connected 属性就会返回 true。 process.disconnect() 被调用后，此属性会返回 false。一旦 process.connected 为 false，则不能通过 IPC 通道使用 process.send() 发送信息。
process.exitCode 当进程正常退出，或通过 process.exit() 退出且未指定退出码时，此数值将作为进程的退出码。指定 process.exit(code) 的退出码将覆盖 process.exitCode 的原有设置。
process.stderr 连接到 stderr (fd 2) 的流。它是一个 net.Socket 流（也就是双工流），除非 fd 2 指向一个文件，在这种情况下它是一个可写流。
- process.stderr.fd 此属性引用process.stderr的基础文件描述符的值。该值固定为2。在 Worker 线程中该值不存在
process.stdin 连接到 stdin (fd 0) 的流。它是一个 net.Socket 流（也就是双工流），除非 fd 0 指向一个文件，在这种情况下它是一个可读流。
- process.stdin.fd 此属性引用process.stderr的基础文件描述符的值。该值固定为0。在 Worker 线程中该值不存在
process.stdout 连接到 stdout (fd 1) 的流。它是一个 net.Socket 流（也就是双工流），除非 fd 1 指向一个文件，在这种情况下它是一个可写流。
- process.stdout.fd 此属性引用process.stderr的基础文件描述符的值。该值固定为1。在 Worker 线程中该值不存在进程 I/O 的注意事项

进程 I/O 的注意事项

process.stdout and process.stderr 与 Node.js 中其他 streams 在重要的方面有不同:

1、console.log() 和 console.error() 内部分别是由它们实现的。
2、写操作是否为同步，取决于连接的是什么流以及操作系统是 Windows 还是 POSIX :
- 文件：在 Windows 和 POSIX 上是同步的。
- TTY（终端）：在 Windows 上是异步的，在 POSIX 上是同步的。
- 管道（和 socket）：在 Windows 上是同步的，在 POSIX 上是异步的。这些行为部分是历史原因，改变他们可能导致向后不兼容，而且他们的行为也符合部分用户的预期。

同步写避免了调用 console.log() 或 console.error() 产生不符合预期的交错输出问题，或是在异步写完成前调用了process.exit()导致未写完整。

同步写将会阻塞事件循环直到写完成。有时可能一瞬间就能写到一个文件，但当系统处于高负载时，管道的接收端可能不会被读取、缓慢的终端或文件系统，因为事件循环被阻塞的足够频繁且足够长的时间，这些可能会给系统性能带来消极的影响。当你向一个交互终端会话写时这可能不是个问题，但当生产日志到进程的输出流时要特别留心。

如果要检查一个流是否连接到了一个 TTY 上下文，检查 isTTY 属性。

process.traceDeprecation

进程方法

process.cwd() Node.js 进程的当前工作目录
process.chdir(directory) 变更 Node.js 进程的当前工作目录，如果变更目录失败会抛出异常。此特性在 Worker 线程中不可用。
process.channel 如果 Node.js 进程是由 IPC 通道方式创建的， process.channel 属性保存 IPC 通道的引用。如果 IPC 通道不存在，则此属性值为 undefined。
- process.channel.ref()
- process.channel.unref()
process.cpuUsage([previousValue]) 返回包含当前进程的用户 CPU 时间和系统 CPU 时间的对象。此对象包含 user 和 system 属性，属性值的单位都是微秒（百万分之一秒）。用户和系统的属性值分别计算了执行用户程序和系统程序的时间，如果此进程在执行任务时是基于多核 CPU，值可能比实际花费的时间要大。可以上一次调用 process.cpuUsage() 方法的结果，作为参数值传递给此方法，得到的结果是与上一次的差值。
process.memoryUsage() 当前 Node.js 进程的内存使用情况的对象，该对象每个属性值的单位为字节
- 返回:
  - rss <integer> 驻留集大小, 是给这个进程分配了多少物理内存（占总分配内存的一部分），包含所有的 C++ 和 JavaScript 对象与代码。
  - heapTotal <integer> V8 的内存使用情况
  - heapUsed <integer> V8 的内存使用情况
  - external <integer> V8 管理的，绑定到 Javascript 的 C++ 对象的内存使用情况
  - arrayBuffers <integer> 分配给 ArrayBuffer 和 SharedArrayBuffer 的内存，包括所有的 Node.js Buffer。这也包含在 external 值中。当 Node.js 用作嵌入式库时，此值可能为 0，因为在这种情况下可能无法跟踪 ArrayBuffer 的分配。
- 使用 Worker 线程时， rss 将会是一个对整个进程有效的值，而其他字段只指向当前线程。
- process.resourceUsage() 当前 node.js 进程的资源使用情况
  - userCPUTime <integer> 映射到以微秒计算的ru_utime。它与process.cpuUsage().user的值相同。 systemCPUTime <integer> 映射到以微秒计算的ru_stime。它与process.cpuUsage().)system的值相同。 maxRSS <integer> 映射到ru_maxrss，这是以千字节为单位使用的最大居民集大小。 sharedMemorySize <integer> 映射到ru_ixrss，尚无平台支持 unsharedDataSize <integer> 映射到ru_idrss，尚无平台支持 unsharedStackSize <integer> 映射到ru_isrss，尚无平台支持 minorPageFault <integer> 映射到ru_minflt，这是该进程的次要页面错误数 majorPageFault <integer> 映射到ru_majflt，这是该过程的主要页面错误数， Windows不支持该字段。 swappedOut <integer> 映射到ru_nswap，尚无平台支持 fsRead <integer> 映射到ru_inblock，这是文件系统必须执行输入的次数。 fsWrite <integer> 映射到ru_oublock，这是文件系统必须执行输出的次数。 ipcSent <integer> 映射到ru_msgsnd，尚无平台支持 ipcReceived <integer> 映射到ru_msgrcv，尚无平台支持 signalsCount <integer> 映射到ru_nsignals，尚无平台支持 voluntaryContextSwitches <integer> 映射到ru_nvcsw，它是由于进程在完成其时间片之前自愿放弃处理器（通常是等待资源的可用性）而导致的CPU上下文切换导致的CPU上下文切换次数。 Windows不支持该字段。 involuntaryContextSwitches <integer> 映射到ru_nivcsw，这是由于优先级较高的进程变得可运行或当前进程超出其时间范围而导致的CPU上下文切换的次数。 Windows不支持该字段。
- process.disconnect()
  - 如果 Node.js 进程是从 IPC 通道衍生出来的（参见子进程和集群的文档），则 process.disconnect() 函数会关闭到父进程的 IPC 通道，以允许子进程一旦没有其他链接来保持活跃就优雅地关闭。
  - 调用 process.disconnect() 的效果和父进程调用 ChildProcess.disconnect() 的一样。
  - 如果 Node.js 进程不是从 IPC 通道衍生出来的，则调用 process.disconnect() 将会返回 undefined。
- process.dlopen(module, filename[, flags]) 动态加载共享对象
  - 它主要由 require() 用于加载 C++ 插件，除特殊情况外，不应直接使用。换句话说，除非有特殊原因，否则 require() 应优先于 process.dlopen()。
  - flags 参数是一个允许指定 dlopen 行为的整数
  - 如果有特定原因要使用 process.dlopen()，使用 require.resolve() 来查找模块的路径通常很有用。
  - 调用 process.dlopen() 时的一个重要缺点是必须传入 module 实例。可以通过 module.exports 访问 C++ 插件导出的函数。
- process.emitWarning(warning[, options]) 触发自定义或应用特定的进程警告。可以通过给 'warning' 事件增加处理程序来监听这些警告。
  - warning <string> | <Error> 触发的警告。如果 warning 是一个 Error 对象，则 options 参数会被忽略。
  - options <Object>
    - type <string> 当 warning 是一个 String 时，则 type 是用于被触发的警告类型的名称。默认值: 'Warning'。
    - code <string> 要触发的警告实例的唯一标识符。
    - ctor <Function> 当 warning 是一个 String 时，则 ctor 是一个可选的函数，用于限制生成的堆栈信息。默认值: process.emitWarning。
    - detail <string> 错误的附加信息。
- process.emitWarning(warning[, type[, code]][, ctor]) 用于触发自定义或应用特定的进程警告。可以通过给 'warning' 事件增加处理程序来监听这些警告。
  - warning <string> | <Error> 触发的警告。如果 warning 是一个 Error 对象，则它将会被透传给 'warning' 事件处理程序（并且将会忽略可选的 type、 code 和 ctor 参数）。如果 warning 不是一个字符串或 Error，则会抛出 TypeError。
  - type <string> 当 warning 是一个 String 时，则 type 是用于被触发的警告类型的名称。默认值: 'Warning'。
  - code <string> 要触发的警告实例的唯一标识符。
  - ctor <Function> 当 warning 是一个 String 时，则 ctor 是一个可选的函数，用于限制生成的堆栈信息。默认值: process.emitWarning。
  - 当进程警告使用 Error 对象时，进程警告机制并不是常用的错误处理机制的替代方式。
  - 如果警告的 type 是 'DeprecationWarning'，则会涉及如下额外的处理：
    - 如果使用 --throw-deprecation 命令行标识，则弃用的警告会作为异常抛出，而不是作为事件被触发。
    - 如果使用--no-deprecation 命令行标识，则弃用的警告会被忽略。
    - 如果使用--trace-deprecation 命令行标识，则弃用的警告及其全部堆栈信息会被打印到 stderr。
- 避免重复告警：作为最佳实践，警告应该在每个进程中最多发出一次
- process.getegid() 进Node.js 进程的有效数字标记的组身份
- process.setegid(id) 为进程设置有效的组标识。id 可以传入数字 ID 或组名字符串。如果指定了组名，则此方法在解析关联的数字 ID 时会阻塞。这个函数只在 POSIX 平台有效（在 Windows 或 Android 平台无效）。此特性在 Worker 线程中不可用。
- process.geteuid() 进程的数字标记的用户身份
- process.seteuid(id) 为进程设置有效的用户标识。id 可以传入数字 ID 或用户名字符串。如果指定了用户名，则此方法在解析关联的数字 ID 这个函数只在 POSIX 平台有效（在 Windows 或 Android 平台无效）。 Worker 线程中不可用。
- process.getgid() Node.js 进程的数字标记的组身份
- process.setgid(id) 为进程设置组标识。 id 可以传入数字 ID 或组名字符串。如果指定了组名，则此方法在解析关联的数字 ID 时会阻塞。这个函数只在 POSIX 平台有效（在 Windows 或 Android 平台无效）。此特性在 Worker 线程中不可用。
- process.getgroups()
- process.setgroups(groups)
- process.getuid() 进程的数字标记的用户身份
- process.setuid(id) 为进程设置用户标识。 id 可以传入数字 ID 或用户名字符串。如果指定了用户名，则此方法在解析关联的数字 ID 时会阻塞。这个函数只在 POSIX 平台有效（在 Windows 或 Android 平台无效）。此特性在 Worker 线程中不可用。s
- process.initgroups(user, extraGroup) 读取 /etc/group 文件，并且初始化组访问列表，该列表包括了用户所在的所有组。
  - 要 Node.js 进程有 root 访问或者有CAP_SETGID 能力才能操作。
  - 这个函数只在 POSIX 平台有效（在 Windows 或 Android 平台无效）。此特性在 Worker 线程中不可用。
- process.hasUncaughtExceptionCaptureCallback() 表明是否已使用 process.setUncaughtExceptionCaptureCallback() 设置回调。
- process.setUncaughtExceptionCaptureCallback(fn)
- process.uptime() 回当前 Node.js 进程运行时间秒长。该返回值包含秒的分数。使用 Math.floor() 来得到整秒钟。
- process.hrtime.bigint() 当前的高精度实际时间（以纳秒为单位的 bigint 型）。
- process.hrtime([time]) 返回当前时间以 [seconds, nanoseconds] 元数组表示的高精度解析值，其中 nanoseconds 是当前时间无法使用秒的精度表示的剩余部分。
  - time <integer[]> 上一次调用 process.hrtime() 返回的结果，用于与当次调用做差值计算。如果此参数传入的不是一个元数组，则会抛出 TypeError。给此参数传入一个用户定义的数组，而不是传入上次调用 process.hrtime() 的结果，则会导致未定义的行为。
  - 返回: <integer[]> 相对于过去某一时刻的值，与一天中的时钟时间没有关系，因此不受制于时钟偏差。此方法最主要的作用是衡量间隔操作的性能
  - 引入 bigint 之前的 process.hrtime.bigint() 的遗留版本
- process.send(message[, sendHandle[, options]][, callback])
  - message <Object>
  - sendHandle <net.Server> | <net.Socket>
  - options <Object> 用于参数化某些类型的句柄的发送。options 支持以下属性：
    - keepOpen <boolean> 当传递 net.Socket 实例时可以使用的值。当为 true 时，套接字在发送的过程中保持打开状态。默认值: false。
  - callback <Function>
  - 返回: <boolean>
  - 如果 Node.js 是使用 IPC 通道衍生的，则可以使用 process.send() 方法将消息发送到父进程。消息将会作为父进程的 ChildProcess 对象上的 'message' 事件被接收。
  - 如果 Node.js 不是通过 IPC 通道衍生的，则 process.send 将会是 undefined。
  - 消息会进行序列化和解析。生成的消息可能与最初发送的消息不同。
- process.kill(pid[, signal]) 将 signal 发送给 pid 标识的进程，只是发送信号，可能是做一些与杀死目标进程无关的事情
  - pid <number> 进程 ID。如果目标 pid 不存在，该方法会抛出错误。
  - signal <string> | <number> 将发送的信号，类型为字符串或数字。默认值: 'SIGTERM'。
  - 信号 0 可以用于测试进程是否存在
  - 在 Windows 平台中，如果 pid 用于杀死进程组，则会抛出错误。
- process.exit([code]) 强制进程尽快退出，即使还有尚未完全完成的异步操作，包括对 process.stdout 和 process.stderr 的 I/O 操作。在调用所有的 'exit' 事件监听器之前，Node.js 不会终止。
  - code <integer> 退出码。指示 Node.js 以退出状态 code 同步地终止进程。默认值: 0。如果省略 code，则使用成功代码 0 或 process.exitCode 的值（如果已设置）退出。
  - 在大多数情况下，实际上不必显式地调用 process.exit()。如果事件循环中没有待处理的额外工作，则 Node.js 进程将自行退出。 process.exitCode 属性可以设置为告诉进程当进程正常退出时使用哪个退出码。
  - 代码不应直接调用 process.exit()，而应设置 process.exitCode 并允许进程自然退出，避免为事件循环调度任何其他工作
  - 如果由于错误条件而需要终止 Node.js 进程，则抛出未被捕获的错误并允许进程相应地终止，这比调用 process.exit() 更安全。
  - 在 Worker 线程中，此函数将停止当前线程而不是当前进程。
- process.abort() 使 Node.js 进程立即结束，并生成一个核心文件。Worker 线程中没有此特性。
- process.nextTick(callback[, ...args]) 将 callback 添加到下一个时间点的队列。在 JavaScript 堆栈上的当前操作运行完成之后以及允许事件循环继续之前，此队列会被完全耗尽。如果要递归地调用 process.nextTick()，则可以创建无限的循环。
- process.report
  - process.report.compact
  - process.report.directory
  - process.report.filename
  - process.report.signal
  - process.report.reportOnSignal
  - process.report.reportOnFatalError
  - process.report.reportOnUncaughtException
  - process.report.getReport([err])
  - process.report.writeReport([filename][, err])
- process.umask(mask) 设置 Node.js 进程的文件模式的创建掩码。子进程从父进程继承掩码。返回上一个掩码。在 Worker 线程中， process.umask(mask) 会抛出异常。

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

process.md

process.md

process（进程）

进程属性

进程 I/O 的注意事项

进程方法

进程事件

退出码

Files

process.md

Latest commit

History

process.md

File metadata and controls

process（进程）

进程属性

进程 I/O 的注意事项

进程方法

进程事件

退出码