Node.js 进程

时间 2019-11-08

标签 node.js node 进程栏目 Node.js 繁體版

原文原文链接

process 是全局对象，可以在任意位置访问，是 EventEmitter 的实例。javascript

退出状态码

当没有新的异步的操做等待处理时，Node 正常状况下退出时会返回状态码 0 。下面的状态码表示其余状态：css

1 未捕获的致命异常-Uncaught Fatal Exception - 有未捕获异常，而且没有被域或 uncaughtException 处理函数处理。
2 - Unused (保留)
3 JavaScript解析错误-Internal JavaScript Parse Error - JavaScript的源码启动 Node 进程时引发解析错误。很是罕见，仅会在开发 Node 时才会有。
4 JavaScript评估失败-Internal JavaScript Evaluation Failure - JavaScript的源码启动 Node 进程，评估时返回函数失败。很是罕见，仅会在开发 Node 时才会有。
5 致命错误-Fatal Error - V8 里致命的不可恢复的错误。一般会打印到 stderr ，内容为： FATAL ERROR
6 Non-function 异常处理-Non-function Internal Exception Handler - 未捕获异常，内部异常处理函数不知为什么设置为on-function，而且不能被调用。
7 异常处理函数运行时失败-Internal Exception Handler Run-Time Failure - 未捕获的异常，而且异常处理函数处理时本身抛出了异常。例如，若是 process.on('uncaughtException') 或 domain.on('error') 抛出了异常。
8 - Unused保留. 以前版本的 Node， 8 有时表示未捕获异常。
9 - 参数非法-Invalid Argument - 多是给了未知的参数，或者给的参数没有值。
10 运行时失败-Internal JavaScript Run-Time Failure - JavaScript的源码启动 Node 进程时抛出错误，很是罕见，仅会在开发 Node 时才会有。
12 无效的 Debug 参数-Invalid Debug Argument - 设置了参数--debug 和/或 --debug-brk，可是选择了错误端口。
>128 信号退出-Signal Exits - 若是 Node 接收到致命信号，好比SIGKILL 或 SIGHUP，那么退出代码就是128 加信号代码。这是标准的 Unix 作法，退出信号代码放在高位。

事件: 'exit'

当进程准备退出时触发。此时已经没有办法阻止从事件循环中推出。所以，你必须在处理函数中执行同步操做。这是一个在固定事件检查模块状态（好比单元测试）的好时机。回调函数有一个参数，它是进程的退出代码。html

监听 exit 事件的例子:java

process.on('exit', function(code) { // do *NOT* do this setTimeout(function() { console.log('This will not run'); }, 0); console.log('About to exit with code:', code); });

事件: 'beforeExit'

当 node 清空事件循环，而且没有其余安排时触发这个事件。一般来讲，当没有进程安排时 node 退出，可是 'beforeExit' 的监听器能够异步调用，这样 node 就会继续执行。node

'beforeExit' 并非明确退出的条件，process.exit() 或异常捕获才是，因此不要把它当作'exit' 事件。除非你想安排更多的工做。linux

事件: 'uncaughtException'

当一个异常冒泡回到事件循环，触发这个事件。若是给异常添加了监视器，默认的操做（打印堆栈跟踪信息并退出）就不会发生。npm

监听 uncaughtException 的例子:json

process.on('uncaughtException', function(err) { console.log('Caught exception: ' + err); }); setTimeout(function() { console.log('This will still run.'); }, 500); // Intentionally cause an exception, but don't catch it. nonexistentFunc(); console.log('This will not run.');

注意，uncaughtException 是很是简略的异常处理机制。vim

尽可能不要使用它，而应该用 domains 。若是你用了，每次未处理异常后，重启你的程序。数组

不要使用 node.js 里诸如 On Error Resume Next 这样操做。每一个未处理的异常意味着你的程序，和你的 node.js 扩展程序，一个未知状态。盲目的恢复意味着 任何事情 均可能发生

你在升级的系统时拉掉了电源线，而后恢复了。可能10次里有9次没有问题，可是第10次，你的系统可能就会挂掉。

Signal 事件

当进程接收到信号时就触发。信号列表详见标准的 POSIX 信号名，如 SIGINT、SIGUSR1 等

监听 SIGINT 的例子:

// Start reading from stdin so we don't exit. process.stdin.resume(); process.on('SIGINT', function() { console.log('Got SIGINT. Press Control-D to exit.'); });

在大多数终端程序里，发送 SIGINT 信号的简单方法是按下 信号Control-C。

注意:

SIGUSR1 node.js 接收这个信号开启调试模式。能够安装一个监听器，但开始时不会中断调试。
SIGTERM 和 SIGINT 在非 Windows 系统里，有默认的处理函数，退出（伴随退出代码 128 + 信号码）前，重置退出模式。若是这些信号有监视器，默认的行为将会被移除。
SIGPIPE 默认状况下忽略，能够加监听器。
SIGHUP 当 Windowns 控制台关闭的时候生成，其余平台的相似条件，参见signal(7)。能够添加监听者，Windows 平台上 10 秒后会无条件退出。在非 Windows 平台上，SIGHUP 的默认操做是终止 node，可是一旦添加了监听器，默认动做将会被移除。 SIGHUP is to terminate node, but once a listener has been installed its
SIGTERM Windows 不支持, 能够被监听。
SIGINT 全部的终端都支持，一般由CTRL+C 生成（可能须要配置）。当终端原始模式启用后不会再生成。
SIGBREAK Windows 里，按下 CTRL+BREAK 会发送。非 Windows 平台，能够被监听，可是不能发送或生成。
SIGWINCH - 当控制台被重设大小时发送。Windows 系统里，仅会在控制台上输入内容时，光标移动，或者可读的 tty在原始模式上使用。
SIGKILL 不能有监视器，在全部平台上无条件关闭 node。
SIGSTOP 不能有监视器。

Windows 不支持发送信号，可是 node 提供了不少process.kill() 和 child_process.kill() 的模拟：

发送 Sending 信号 0 能够查找运行中得进程
发送 SIGINT, SIGTERM, 和 SIGKILL 会引发目标进程无条件退出。

process.stdout

一个 Writable Stream 执向 stdout (on fd 1).

例如: console.log的定义：

console.log = function(d) { process.stdout.write(d + '\n'); };

process.stderr 和 process.stdout 和 node 里的其余流不一样，他们不会被关闭（end() 将会被抛出），它们不会触发 finish 事件，而且写是阻塞的。

引用指向常规文件或 TTY 文件描述符时，是阻塞的。
引用指向 pipe 管道时:
- 在 Linux/Unix 里阻塞.
- 在 Windows 像其余流同样，不被阻塞

检查 Node 是否运行在 TTY 上下文中，从process.stderr, process.stdout, 或 process.stdin里读取 isTTY 属性。

$ node -p "Boolean(process.stdin.isTTY)" true $ echo "foo" | node -p "Boolean(process.stdin.isTTY)" false $ node -p "Boolean(process.stdout.isTTY)" true $ node -p "Boolean(process.stdout.isTTY)" | cat false

更多信息参见 the tty docs。

process.stderr

一个指向 stderr (on fd 2)的可写流。

process.stderr 和 process.stdout 和 node 里的其余流不一样，他们不会被关闭（end() 将会被抛出），它们不会触发 finish 事件，而且写是阻塞的。

引用指向常规文件或 TTY 文件描述符时，是阻塞的。
引用指向 pipe 管道时:
- 在 Linux/Unix 里阻塞.
- 在 Windows 像其余流同样，不被阻塞

process.stdin

一个指向 stdin (on fd 0)的可读流。

如下例子：打开标准输入流，并监听两个事件:

process.stdin.setEncoding('utf8'); process.stdin.on('readable', function() { var chunk = process.stdin.read(); if (chunk !== null) { process.stdout.write('data: ' + chunk); } }); process.stdin.on('end', function() { process.stdout.write('end'); });

process.stdin 能够工做在老模式里，和 v0.10 以前版本的 node 代码兼容。

更多信息参见Stream compatibility.

在老的流模式里，stdin流默认暂停，必须调用 process.stdin.resume() 读取。能够调用 process.stdin.resume() 切换到老的模式。

若是开始一个新的工程，最好选择新的流，而不是用老的流。

process.argv

包含命令行参数的数组。第一个元素是'node'，第二个参数是 JavaScript 文件的名字，第三个参数是任意的命令行参数。

// print process.argv process.argv.forEach(function(val, index, array) { console.log(index + ': ' + val); });

将会生成:

$ node process-2.js one two=three four 0: node 1: /Users/mjr/work/node/process-2.js 2: one 3: two=three 4: four

process.execPath

开启当前进程的执行文件的绝对路径。

例子:

/usr/local/bin/node

process.execArgv

启动进程所需的 node 命令行参数。这些参数不会在 process.argv 里出现，而且不包含 node 执行文件的名字，或者任何在名字以后的参数。这些用来生成子进程，使之拥有和父进程有相同的参数。

例子:

$ node --harmony script.js --version

process.execArgv 的参数:

['--harmony']

process.argv 的参数:

['/usr/local/bin/node', 'script.js', '--version']

process.abort()

这将致使 node 触发 abort 事件。会让 node 退出并生成一个核心文件。

process.chdir(directory)

改变当前工做进程的目录，若是操做失败抛出异常。

console.log('Starting directory: ' + process.cwd()); try { process.chdir('/tmp'); console.log('New directory: ' + process.cwd()); } catch (err) { console.log('chdir: ' + err); }

process.cwd()

返回当前进程的工做目录

console.log('Current directory: ' + process.cwd());

process.env

包含用户环境的对象，参见 environ(7).

这个对象的例子：

{ TERM: 'xterm-256color', SHELL: '/usr/local/bin/bash', USER: 'maciej', PATH: '~/.bin/:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin', PWD: '/Users/maciej', EDITOR: 'vim', SHLVL: '1', HOME: '/Users/maciej', LOGNAME: 'maciej', _: '/usr/local/bin/node' }

你能够写入这个对象，可是不会改变当前运行的进程。如下的命令不会成功：

node -e 'process.env.foo = "bar"' && echo $foo

这个会成功:

process.env.foo = 'bar'; console.log(process.env.foo);

process.exit([code])

使用指定的 code 结束进程。若是忽略，将会使用 code 0

使用失败的代码退出：

process.exit(1);

Shell 将会看到退出代码为1.