Node.js API —— process（进程）

2022-02-11 16:16:42

// 说明

Node API 版本为 v0.10.31。
中文参考：http://nodeapi.ucdok.com/#/api/，http://blog.sina.com.cn/oleoneoy

本段为博主注解。

进程

process 对象是一个全局对象，能在任何地方被访问。它是一个 EventEmitter 实例。

Event: ‘exit‘

当进程将要退出时发射。在这个时候没有任何途径来阻止退出事件循环，且当所有的 exit 监听器运行完之后进程将会退出。因此，在本监听器内你必须只使用同步的操作。这是一个很好的执行模块状态的检验的钩子（比如用于单元测试上）。回调函数有一个参数，即进程的退出码。
监听 exit 的例子：

1 process.on(‘exit‘, function(code) {
2   // do *NOT* do this
3   setTimeout(function() {
4     console.log(‘This will not run‘);
5   }, 0);
6   console.log(‘About to exit with code: ‘, code);
7 });

Event: ‘uncaughtException‘

当一个异常一路冒泡到事件循环时发射。如果为这个异常添加了一个监听器，那么默认的动作（打印堆栈信息并退出）将不会被触发。
监听 uncaughtException 的例子：

 1 process.on(‘uncaughtException‘, function(err) {
 2   console.log(‘Caught exception: ‘ + err);
 3 });
 4 
 5 setTimeout(function() {
 6   console.log(‘This will still run.‘);
 7 }, 500);
 8 
 9 // Intentionally cause an exception, but don‘t catch it
10 nonexitstentFunc();
11 console.log(‘This will not run.‘);

注意 uncaughtException 是一种非常粗鲁的异常捕获途径且有可能在将来移除。
不要使用它，使用 domains 取代。如果你使用了它，在每个没被正常捕获的异常后重启你的应用程序。
不要使用它因为 node.js 相当于出了错待会恢复重新开始。一个未捕获的异常意味着你的应用程序——推而广之 node.js 本身处于未知状态。盲目地恢复意味着什么事情都有可发生。
假想当你正在升级系统时拔了电源线，然后恢复了。十次有九次都没事发生——但在第十次，你的系统就崩了。
你已经被警告过。

Signal Events

当进程受到一个信号时发射。参看 sigaction(2) 列出的标注 POSIX 信号，例如 SIGINT，SIGHUP等。
监听 SIGINT 的例子：

1 // Start reading from stdin so we don‘t exit.
2 process.stdin.resume();
3 
4 process.on(‘SIGINT‘, function() {
5   console.log(‘Got SIGINT. Press Control-D to exit.‘);
6 });

在大多数的终端程序中一个简单的发送 SIGINT 信号的方法是使用 Control-C。
注意：

SIGUSR1 被 node.js 保留用以启动 debugger。可以创建一个监听器但那不会停止 debugger 的启动。
SIGTERM 和 SIGINT 在非 Windows 平台下有默认的监听器，退出并在退出前重置终端 mode 为128加信号数值。如果这两信号之一创建了监听器，它们的默认操作将会被移除（node 将永不退出）。
SIGPIPE 默认被忽略，他可以创建监听器。
SIGHUP 在 Windows 下当控制台窗口被关闭时产生，在其他平台各个类似的条件下，参看 signal(7)。它可以创建监听器，然而 node 将在大约10秒后被 Windows 无条件终止。在非 Windows 平台下，SIGHUP 的默认行为是终止 node，但一旦创建了监听器默认的行为将被移除。
SIGTERM 在 Windows 下不支持，可以被监听。
SIGINT 从终端发送该信号能被所有平台支持，且通常可以用 CTRL+C 产生（即使这是可配置的）。当终端 raw 模式启动时它不能被产生。
SIGBREAK 在 Windows 下当按下 CTRL+BREAK 时产生，在非 Windows 平台下可以别监听，但没有途径可以发送或产生它。
SIGWINCH 当控制台改变大小时产生。在 Windows 下，这只会发生在鼠标正在移动时向控制台输入，或刻度的 tty 在 raw 模式下使用。
SIGKILL 不可被监听，在任何平台下 node 都将无条件终止。
SIGSTOP 不可被监听。

注意 Windows 不支持发送信号，但 node 使用 process.kill() 和 child_process.kill() 提供了一些模拟：——发送信号0可以用来查找进程是否存在——发送 SIGINT，SIGTERM 和 SIGKILL 让目标进程无条件退出。

process.stdout

写向标准输出的可写流。
例子：console.log 的定义

1 console.log = function(d) {
2   process.stdout.write(d + ‘\n‘);
3 };

process.stderr 和 process.stdout 和 Node 中的其他流不同，向它们写入通常是阻塞的。

当它们指向普通文件或 TTY 文件描述符时它们是阻塞的。
当它们指向管道：
○ 在 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

更多信息参看 tty 文档。

process.stderr

写向标准错误输出的可写流。
process.stderr 和 process.stdout 和 Node 中的其他流不同，向它们写入通常是阻塞的。

当它们指向普通文件或 TTY 文件描述符时它们是阻塞的。
当它们指向管道：
○ 在 Linux/Unix 下是阻塞的。
○ 在 Windows 下与其他流一样是非阻塞的。

process.stdin

标准输入的可写流。
打开标准输入并监听两个事件的例子：

 1 process.stdin.setEncoding(‘utf8‘);
 2 
 3 process.stdin.on(‘readable‘, function() {
 4   var chunk = process.stdin.read();
 5   if (chunk !== null) {
 6     process.stdout.write(‘data ‘ + chunk);
 7   }
 8 });
 9 
10 process.stdin.on(‘end‘, function() {
11   process.stdout.write(‘end‘);
12 });

作为一个流，process.stdin 也可以用于“老”模式，那是为了兼容使用 v0.10 之前的 node 所写的代码。更多信息参看流兼容性。
在“老”模式下标准输入流默认是暂停的，所以必须调用 process.stdin.resume() 来从从里面读取。而且需要注意调用 process.stdin.resume() 本身会将流选择为“老”模式。
如果你正在启动一个新项目，你应该选择更现代的“新”流模式而不是“老”的。

process.argv

一个包含命令行参数的数组。第一个元素为 ‘node‘，第二个元素为 JavaScript 文件名。剩下的参数为附加的命令行参数。

1 // print process.argv
2 process.argv.forEach(function(val, index, array) {
3   console.log(index + ‘: ‘ + val);
4 });

输出将会是：

$ node process-2.js one two=three four
0: node
1: /User/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)

改变进程的当前工作目录或如果失败则抛出一个异常。

1 console.log(‘Starting directory: ‘ + process.cwd());
2 try {
3   process.chdir(‘/tmp‘);
4   console.log(‘New directory: ‘ + process.cwd());
5 }
6 catch (err) {
7   console.log(‘chdir: ‘ + err);
8 }

process.cwd()

返回进程的当前工作目录。

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

process.env

一个包含用户环境的对象。参看 environ(7)。

process.exit([code])

使用指定的 code 停止进程。如果省略，使用“成功”码 0 退出。

使用一个“失败”码退出：

1 process.exit(1);

执行 node 的 shell 将看到1作为退出码。