13.7 process对象
最后更新于：2022-04-01 05:09:42
process对象是Node的一个全局对象，提供当前node进程的信息。它可以在脚本的任意位置使用，不必通过require命令加载。该对象部署了EventEmitter接口。
[TOC]
## 进程信息
通过process对象，可以获知当前进程的很多信息。
### 退出码
进程退出时，会返回一个整数值，表示退出时的状态。这个整数值就叫做退出码。下面是常见的Node进程退出码。
* 0，正常退出
* 1，发生未捕获错误
* 5，V8执行错误
* 8，不正确的参数
* 128 + 信号值，如果Node接受到退出信号（比如SIGKILL或SIGHUP），它的退出码就是128加上信号值。由于128的二进制形式是10000000, 所以退出码的后七位就是信号值。
## 属性
process对象提供一系列属性，用于返回系统信息。
* process.argv：返回当前进程的命令行参数数组。
* process.env：返回一个对象，成员为当前shell的环境变量，比如process.env.HOME。
* process.installPrefix：node的安装路径的前缀，比如`/usr/local`，则node的执行文件目录为`/usr/local/bin/node`。
* process.pid：当前进程的进程号。
* process.platform：当前系统平台，比如Linux。
* process.title：默认值为“node”，可以自定义该值。
* process.version：Node的版本，比如v0.10.18。
下面是主要属性的介绍。
### stdout，stdin，stderr
以下属性指向系统IO。
（1）stdout
stdout属性指向标准输出（文件描述符1）。它的write方法等同于console.log，可用在标准输出向用户显示内容。
~~~
console.log = function(d) {
process.stdout.write(d + '\n');
};
~~~
下面代码表示将一个文件导向标准输出。
~~~
var fs = require('fs');
fs.createReadStream('wow.txt')
.pipe(process.stdout);
~~~
上面代码中，由于process.stdout和process.stdin与其他进程的通信，都是流（stream）形式，所以必须通过pipe管道命令中介。
~~~
var fs = require('fs');
var zlib = require('zlib');
fs.createReadStream('wow.txt')
.pipe(zlib.createGzip())
.pipe(process.stdout);
~~~
上面代码通过pipe方法，先将文件数据压缩，然后再导向标准输出。
（2）stdin
stdin代表标准输入（文件描述符0）。
~~~
process.stdin.pipe(process.stdout)
~~~
上面代码表示将标准输入导向标准输出。
由于stdin和stdout都部署了stream接口，所以可以使用stream接口的方法。
~~~
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');
});
~~~
（3）stderr
stderr属性指向标准错误（文件描述符2）。
### argv，execPath，execArgv
argv属性返回一个数组，由命令行执行脚本时的各个参数组成。它的第一个成员总是node，第二个成员是脚本文件名，其余成员是脚本文件的参数。
请看下面的例子，新建一个脚本文件argv.js。
~~~
// argv.js
console.log("argv: ",process.argv);
~~~
在命令行下调用这个脚本，会得到以下结果。
~~~
$ node argv.js a b c
[ 'node', '/path/to/argv.js', 'a', 'b', 'c' ]
~~~
上面代码表示，argv返回数组的成员依次是命令行的各个部分，真正的参数实际上是从`process.argv[2]`开始。要得到真正的参数部分，可以把argv.js改写成下面这样。
~~~
// argv.js
var myArgs = process.argv.slice(2);
console.log(myArgs);
~~~
execPath属性返回执行当前脚本的Node二进制文件的绝对路径。
~~~
> process.execPath
'/usr/local/bin/node'
>
~~~
execArgv属性返回一个数组，成员是命令行下执行脚本时，在Node可执行文件与脚本文件之间的命令行参数。
~~~
# script.js的代码为
# console.log(process.execArgv);
$ node --harmony script.js --version
~~~
## 方法
process对象提供以下方法：
* process.chdir()：切换工作目录到指定目录。
* process.cwd()：返回运行当前脚本的工作目录的路径。
* process.exit()：退出当前进程。
* process.getgid()：返回当前进程的组ID（数值）。
* process.getuid()：返回当前进程的用户ID（数值）。
* process.nextTick()：指定回调函数在当前执行栈的尾部、下一次Event Loop之前执行。
* process.on()：监听事件。
* process.setgid()：指定当前进程的组，可以使用数字ID，也可以使用字符串ID。
* process.setuid()：指定当前进程的用户，可以使用数字ID，也可以使用字符串ID。
### process.cwd()，process.chdir()
cwd方法返回进程的当前目录，chdir方法用来切换目录。
~~~
> process.cwd()
'/home/aaa'
> process.chdir('/home/bbb')
> process.cwd()
'/home/bbb'
~~~
## process.nextTick()
process.nextTick()将任务放到当前执行栈的尾部。
~~~
process.nextTick(function () {
console.log('下一次Event Loop即将开始!');
});
~~~
上面代码可以用`setTimeout(f,0)`改写，效果接近，但是原理不同。`setTimeout(f,0)`是将任务放到当前任务队列的尾部，在下一次Event Loop时执行。另外，nextTick的效率更高，因为不用检查是否到了指定时间。
~~~
setTimeout(function () {
console.log('已经到了下一轮Event Loop！');
}, 0)
~~~
### process.exit()
process.exit方法用来退出当前进程，它可以接受一个数值参数。如果参数大于0，表示执行失败；如果等于0表示执行成功。
~~~
if (err) {
process.exit(1);
} else {
process.exit(0);
}
~~~
process.exit()执行时，会触发exit事件。
### process.on()
process.on方法用来监听各种事件，并指定回调函数。
~~~
process.on('uncaughtException', function(err){
console.log('got an error: %s', err.message);
process.exit(1);
});
setTimeout(function(){
throw new Error('fail');
}, 100);
~~~
上面代码是process监听Node的一个全局性事件uncaughtException，只要有错误没有捕获，就会触发这个事件。
process支持的事件有以下一些。
* data事件：数据输出输入时触发
* SIGINT事件：接收到系统信号时触发
~~~
process.on('SIGINT', function () {
console.log('Got a SIGINT. Goodbye cruel world');
process.exit(0);
});
~~~
使用时，向该进程发出系统信号，就会导致进程退出。
~~~
$ kill -s SIGINT [process_id]
~~~
SIGTERM信号表示内核要求当前进程停止，进程可以自行停止，也可以忽略这个信号。
~~~
var http = require('http');
var server = http.createServer(function (req, res) {
});
process.on('SIGTERM', function () {
server.close(function () {
process.exit(0);
});
});
~~~
上面代码表示，进程接到SIGTERM信号之后，关闭服务器，然后退出进程。需要注意的是，这时进程不会马上退出，而是要回应完最后一个请求，处理完所有回调函数，然后再退出。
### process.kill()
process.kill方法用来对指定ID的线程发送信号，默认为SIGINT信号。
~~~
process.on('SIGTERM', function(){
console.log('terminating');
process.exit(1);
});
setTimeout(function(){
console.log('sending SIGTERM to process %d', process.pid);
process.kill(process.pid, 'SIGTERM');
}, 500);
setTimeout(function(){
console.log('never called');
}, 1000);
~~~
上面代码中，500毫秒后向当前进程发送SIGTERM信号（终结进程），因此1000毫秒后的指定事件不会被触发。
## 事件
### exit事件
当前进程退出时，会触发exit事件，可以对该事件指定回调函数。
~~~
process.on('exit', function () {
fs.writeFileSync('/tmp/myfile', '需要保存到硬盘的信息');
});
~~~
注意，此时回调函数只能执行同步操作，不能包含异步操作，因为执行完回调函数，进程就会退出，无法监听到回调函数的操作结果。
~~~
process.on('exit', function(code) {
// 不会执行
setTimeout(function() {
console.log('This will not run');
}, 0);
});
~~~
上面代码在exit事件的回调函数里面，指定了一个下一轮事件循环，所要执行的操作。这是无效的，不会得到执行。
### beforeExit事件
beforeExit事件在Node清空了Event Loop以后，再没有任何待处理的任务时触发。正常情况下，如果没有任何待处理的任务，Node进程会自动退出，设置beforeExit事件的监听函数以后，就可以提供一个机会，再部署一些任务，使得Node进程不退出。
beforeExit事件与exit事件的主要区别是，beforeExit的监听函数可以部署异步任务，而exit不行。
此外，如果是显式终止程序（比如调用process.exit()），或者因为发生未捕获的错误，而导致进程退出，这些场合不会触发beforeExit事件。因此，不能使用该事件替代exit事件。
### uncaughtException事件
当前进程抛出一个没有被捕捉的错误时，会触发uncaughtException事件。
~~~
process.on('uncaughtException', function (err) {
console.error('An uncaught error occurred!');
console.error(err.stack);
});
~~~
部署uncaughtException事件的监听函数，是免于node进程终止的最后措施，否则node就要执行`process.exit()`。出于除错的目的，并不建议发生错误，还保持进程运行。
抛出错误之前部署的异步操作，还是会继续执行。只有完成以后，Node进程才会退出。
~~~
process.on('uncaughtException', function(err) {
console.log('Caught exception: ' + err);
});
setTimeout(function() {
console.log('本行依然执行');
}, 500);
// 下面的表达式抛出错误
nonexistentFunc();
~~~
上面代码中，抛出错误之后，此前setTimeout指定的回调函数亦然会执行。
### 信号事件
操作系统内核向Node进程发出信号，会触发信号事件。实际开发中，主要对SIGTERM和SIGINT信号部署监听函数，这两个信号在非Windows平台会导致进程退出，但是只要部署了监听函数，Node进程收到信号后就不会退出。
~~~
// 读取标准输入，这主要是为了不让当前进程退出
process.stdin.resume();
process.on('SIGINT', function() {
console.log('SIGINT信号，按Control-D退出');
});
~~~
上面代码部署了SIGINT信号的监听函数，当用户按下Ctrl-C后，会显示提示文字。
## 参考链接
* José F. Romaniello, [Graceful shutdown in node.js](http://joseoncode.com/2014/07/21/graceful-shutdown-in-node-dot-js/)