Node.js API —— process（進程）

時間 2019-11-21

標籤 node.js node api process 進程欄目 Node.js 简体版

原文原文鏈接

// 說明

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 自己處於未知狀態。盲目地恢復意味着什麼事情都有可發生。
假想當你正在升級系統時拔了電源線，而後恢復了。十次有九次都沒事發生——但在第十次，你的系統就崩了。
你已經被警告過。node

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。
注意：linux

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 讓目標進程無條件退出。shell

process.stdout

寫向標準輸出的可寫流。
例子：console.log 的定義

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

process.stderr 和 process.stdout 和 Node 中的其餘流不一樣，向它們寫入一般是阻塞的。npm

當它們指向普通文件或 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 文檔。api

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 的結果：
dom

['/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做爲退出碼。