閱讀(33.7k) 書簽贊(0) 我要糾錯(cuò)

IO.js Process

2018-11-28 22:34 更新

process對象是一個(gè)全局對象，并且何以被在任何地方調(diào)用。這是一個(gè)EventEmitter實(shí)例。

Exit Codes

當(dāng)沒有任何異步操作在等待時(shí)，io.js通常將會(huì)以一個(gè)0為退出碼退出。以下這些狀態(tài)碼會(huì)在其他情況下被用到：

1 未捕獲的致命異常。這是一個(gè)未捕獲的異常，并且它沒有被domain處理，也沒有被uncaughtException處理。
2 未使用（由Bash為內(nèi)建誤操作保留）。
3 內(nèi)部的JavaScript解析錯(cuò)誤。io.js內(nèi)部的JavaScript源碼引導(dǎo)（bootstrapping）造成的一個(gè)解釋錯(cuò)誤。這極其罕見。并且常常只會(huì)發(fā)生在io.js自身的開發(fā)過程中。
4 內(nèi)部的JavaScript求值錯(cuò)誤。io.js內(nèi)部的JavaScript源碼引導(dǎo)（bootstrapping）未能在求值時(shí)返回一個(gè)函數(shù)值。這極其罕見。并且常常只會(huì)發(fā)生在io.js自身的開發(fā)過程中。
5 致命錯(cuò)誤。這是V8中嚴(yán)重的不可恢復(fù)的錯(cuò)誤。典型情況下，一個(gè)帶有FATAL ERROR前綴的信息會(huì)被打印在stderr。
6 內(nèi)部異常處理函數(shù)喪失功能。這是一個(gè)未捕獲異常，但是內(nèi)部的致命異常處理函數(shù)被設(shè)置為喪失功能，并且不能被調(diào)用。
7 內(nèi)部異常處理函數(shù)運(yùn)行時(shí)失敗。這是一個(gè)未捕獲異常，并且內(nèi)部致命異常處理函數(shù)試圖處理它時(shí)，自身拋出了一個(gè)錯(cuò)誤。例如它可能在當(dāng)process.on('uncaughtException')或domain.on('error')處理函數(shù)拋出錯(cuò)誤時(shí)發(fā)生。
8 未使用。io.js的之前版本中，退出碼8通常表示一個(gè)未捕獲異常。
9 無效參數(shù)。當(dāng)一個(gè)位置的選項(xiàng)被指定，或者一個(gè)必選的值沒有被提供。
10 內(nèi)部的JavaScript運(yùn)行時(shí)錯(cuò)誤。io.js內(nèi)部的JavaScript源碼引導(dǎo)（bootstrapping）函數(shù)被調(diào)用時(shí)拋出一個(gè)錯(cuò)誤。這極其罕見。并且常常只會(huì)發(fā)生在io.js自身的開發(fā)過程中。
12 無效的調(diào)試參數(shù)。--debug和/或--debug-brk選項(xiàng)被設(shè)置，當(dāng)時(shí)選擇了一個(gè)無效的端口。
大于128 信號(hào)退出。如果io.js收到了一個(gè)如SIGKILL或SIGHUP的致命信號(hào)，那么它將以一個(gè)128加上信號(hào)碼的值的退出碼退出。這是一個(gè)標(biāo)準(zhǔn)的Unix實(shí)踐，因?yàn)橥顺龃a由一個(gè)7位整數(shù)定義，并且信號(hào)的退出設(shè)置了一個(gè)高順序位（high-order bit），然后包含一個(gè)信號(hào)碼的值。

Event: 'exit'

進(jìn)程即將退出時(shí)觸發(fā)。在這個(gè)時(shí)刻已經(jīng)沒有辦法可以阻止事件循環(huán)的退出，并且一旦所有的exit監(jiān)聽器運(yùn)行結(jié)束時(shí)，進(jìn)程將會(huì)退出。因此，在這個(gè)監(jiān)聽器中你僅僅能調(diào)用同步的操作。這是檢查模塊狀態(tài)（如單元測試）的好鉤子。回調(diào)函數(shù)有一個(gè)退出碼參數(shù)。

例子：

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);
});

Event: 'beforeExit'

這個(gè)事件在io.js清空了它的事件循環(huán)并且沒有任何已安排的任務(wù)時(shí)觸發(fā)。通常io.js當(dāng)沒有更多被安排的任務(wù)時(shí)就會(huì)退出，但是beforeExit中可以執(zhí)行異步調(diào)用，讓io.js繼續(xù)運(yùn)行。

beforeExit在程序被顯示終止時(shí)不會(huì)觸發(fā)，如process.exit()或未捕獲的異常。除非想去安排更多的任務(wù)，否則它不應(yīng)被用來做為exit事件的替代。

Event: 'uncaughtException'

當(dāng)一個(gè)異常冒泡回事件循環(huán)時(shí)就會(huì)觸發(fā)。如果這個(gè)時(shí)間被添加了監(jiān)聽器，那么默認(rèn)行為（退出程序且打印堆棧跟蹤信息）將不會(huì)發(fā)生。

例子：

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來處理異常是非常粗糙的。

請不要使用它，使用domain來替代。如果你已經(jīng)使用了它，請?jiān)诓惶幚磉@個(gè)異常之后重啟你的應(yīng)用。

請不要像io.js的Error Resume Next這樣使用。一個(gè)未捕獲異常意味著你的應(yīng)用或拓展有未定義的狀態(tài)。盲目地恢復(fù)意味著任何事都可能發(fā)生。

想象你在升級(jí)你的系統(tǒng)時(shí)電源被拉斷了。10次中前9次都沒有問題，但是第10次時(shí)，你的系統(tǒng)崩潰了。

你已經(jīng)被警告。

Event: 'unhandledRejection'

在一個(gè)事件循環(huán)中，當(dāng)一個(gè)promise被“拒絕”并且沒有附屬的錯(cuò)誤處理函數(shù)時(shí)觸發(fā)。當(dāng)一個(gè)帶有promise異常的程序被封裝為被“拒絕”的promise時(shí)，這樣的程序的錯(cuò)誤可以被promise.catch(...)捕獲處理并且“拒絕”會(huì)通過promise鏈冒泡。這個(gè)事件對于偵測和保持追蹤那些“拒絕”沒有被處理的promise非常有用。這個(gè)事件會(huì)帶著以下參數(shù)觸發(fā)：

reason promise的“拒絕”對象（通常是一個(gè)錯(cuò)誤實(shí)例）
p 被“拒絕”的promise

下面是一個(gè)把所有未處理的“拒絕”打印到控制臺(tái)的例子：

process.on('unhandledRejection', function(reason, p) {
    console.log("Unhandled Rejection at: Promise ", p, " reason: ", reason);
    // application specific logging, throwing an error, or other logic here
});

下面是一個(gè)會(huì)觸發(fā)unhandledRejection事件的“拒絕”：

somePromise.then(function(res) {
  return reportToUser(JSON.pasre(res)); // note the typo
}); // no `.catch` or `.then`

Event: 'rejectionHandled'

當(dāng)一個(gè)Promise被“拒絕”并且一個(gè)錯(cuò)誤處理函數(shù)被附給了它（如.catch()）時(shí)的下一個(gè)事件循環(huán)之后觸發(fā)。這個(gè)事件會(huì)帶著以下參數(shù)觸發(fā)：

p 一個(gè)在之前會(huì)被觸發(fā)在unhandledRejection事件中，但現(xiàn)在被處理函數(shù)捕獲的promise

一個(gè)promise鏈的頂端沒有 “拒絕”可以總是被處理的概念。由于其異步的本質(zhì)，一個(gè)promise的“拒絕”可以在未來的某一個(gè)時(shí)間點(diǎn)被處理，可以是在事件循環(huán)中被觸發(fā)unhandledRejection事件之后。

另外，不像同步代碼中是一個(gè)永遠(yuǎn)增長的未捕獲異常列表，promise中它是一個(gè)可伸縮的未捕獲拒絕 列表。在同步代碼中，uncaughtException事件告訴你未捕獲異常列表增長了。但是在promise中，unhandledRejection事件告訴你未捕獲“拒絕” 列表增長了，rejectionHandled事件告訴你未捕獲“拒絕” 列表縮短了。

使用“拒絕”偵測鉤子來保持一個(gè)被“拒絕”的promise列表：

var unhandledRejections = [];
process.on('unhandledRejection', function(reason, p) {
    unhandledRejections.push(p);
});
process.on('rejectionHandled', function(p) {
    var index = unhandledRejections.indexOf(p);
    unhandledRejections.splice(index, 1);
});

Signal Events

當(dāng)一個(gè)進(jìn)程收到一個(gè)信號(hào)時(shí)觸發(fā)。參閱sigaction(2)。

監(jiān)聽SIGINT信號(hào)的例子：

// 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.');
});

一個(gè)發(fā)送SIGINT信號(hào)的快捷方法是在大多數(shù)終端中按下 Control-C 。

注意：

SIGUSR1 是io.js用于開啟調(diào)試的保留信號(hào)?？梢詾槠涮砑右粋€(gè)監(jiān)聽器，但不能阻止調(diào)試的開始。
SIGTERM 和 SIGINT在非Windows平臺(tái)下有在以 128 + 信號(hào) 退出碼退出前重置終端模式的默認(rèn)監(jiān)聽器。如果另有監(jiān)聽器被添加，默認(rèn)監(jiān)聽器會(huì)被移除（即io.js將會(huì)不再退出）。
SIGPIPE 默認(rèn)被忽略，可以被添加監(jiān)聽器。
SIGHUP 當(dāng)控制臺(tái)被關(guān)閉時(shí)會(huì)在Windows中產(chǎn)生，或者其他平臺(tái)有其他相似情況時(shí)（參閱signal(7)）。它可以被添加監(jiān)聽器，但是Windows中io.js會(huì)無條件的在10秒后關(guān)閉終端。在其他非Windows平臺(tái)，它的默認(rèn)行為是結(jié)束io.js，但是一旦被添加了監(jiān)聽器，默認(rèn)行為會(huì)被移除。
SIGTERM 在Windows中不被支持，它可以被監(jiān)聽。
SIGINT 支持所有的平臺(tái)?？梢杂?CTRL+C 產(chǎn)生（盡管它可能是可配置的）。當(dāng)啟用終端的raw mode時(shí)，它不會(huì)產(chǎn)生。
SIGBREAK 在Windows中，按下 CTRL+BREAK 時(shí)它會(huì)產(chǎn)生。在非Windows平臺(tái)下，它可以被監(jiān)聽，但它沒有產(chǎn)生的途徑。
SIGWINCH 當(dāng)終端被改變大小時(shí)產(chǎn)生。Windows下，它只會(huì)在當(dāng)光標(biāo)被移動(dòng)時(shí)寫入控制臺(tái)或可讀tty使用raw mode時(shí)發(fā)生。
SIGKILL 可以被添加監(jiān)聽器。它會(huì)無條件得在所有平臺(tái)下關(guān)閉io.js。
SIGSTOP 可以被添加監(jiān)聽器。

注意Windows不支持發(fā)送信號(hào)，但io.js通過process.kill()和child_process.kill()提供了模擬：- 發(fā)送信號(hào)0被用來檢查進(jìn)程的存在 - 發(fā)送SIGINT， SIGTERM 和 SIGKILL 會(huì)導(dǎo)致目標(biāo)進(jìn)程的無條件退出。

process.stdout

一個(gè)指向stdout的可寫流。

例如，console.log可能與這個(gè)相似：

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

在io.js中，process.stderr和process.stdout與其他流不同，因?yàn)樗麄儾荒鼙魂P(guān)閉（調(diào)用end()會(huì)報(bào)錯(cuò)）。它們永遠(yuǎn)不觸發(fā)finish事件并且寫操作通常是阻塞的。

當(dāng)指向普通文件或TTY文件描述符時(shí)，它們是阻塞的。
以下情況下他們指向流
他們在Linux/Unix中阻塞
他們在Windows中的其他流里不阻塞

若要檢查io.js是否在一個(gè)TTY上下文中運(yùn)行，讀取process.stderr，process.stdout或process.stdin的isTTY屬性：

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

$ iojs -p "Boolean(process.stdout.isTTY)"
true
$ iojs -p "Boolean(process.stdout.isTTY)" | cat
false

更多信息請參閱tty文檔。

process.stderr

一個(gè)指向stderr的可寫流。

當(dāng)指向普通文件或TTY文件描述符時(shí)，它們是阻塞的。
以下情況下他們指向流
他們在Linux/Unix中阻塞
他們在Windows中的其他流里不阻塞

process.stdin

一個(gè)指向stdin的可讀流。

一個(gè)打開標(biāo)準(zhǔn)輸入并且監(jiān)聽兩個(gè)事件的例子：

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');
});

作為一個(gè)流，process.stdin可以被切換至“舊”模式，這樣就可以兼容node.js v0.10 前所寫的腳本。更多信息請參閱流的兼容性。

在“舊”模式中stdin流默認(rèn)是被暫停的。所以你必須調(diào)用process.stdin.resume()來讀取。注意調(diào)用process.stdin.resume()這個(gè)操作本身也會(huì)將流切換至舊模式。

如果你正將開啟一個(gè)新的工程。你應(yīng)該要更常使用“新”模式的流。

process.argv

一個(gè)包含了命令行參數(shù)的數(shù)組。第一次元素將會(huì)是'iojs'，第二個(gè)元素將會(huì)是JavaScript文件名。之后的元素將會(huì)是額外的命令行參數(shù)。

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

這將會(huì)是：

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

process.execPath

這將是開啟進(jìn)程的可執(zhí)行文件的絕對路徑名：

例子：

/usr/local/bin/iojs

process.execArgv

這是在啟動(dòng)時(shí)io.js自身參數(shù)的集合。這些參數(shù)不會(huì)出現(xiàn)在process.argv中，并且不會(huì)包含io.js可執(zhí)行文件，腳本名和其他腳本名之后的參數(shù)。這些參數(shù)對開啟和父進(jìn)程相同執(zhí)行環(huán)境的子進(jìn)程非常有用。

例子：

$ iojs --harmony script.js --version

process.execArgv將會(huì)是：

['--harmony']

process.argv將會(huì)是：

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

process.abort()

這將導(dǎo)致io.js觸發(fā)abort事件。這個(gè)將導(dǎo)致io.js退出，并創(chuàng)建一個(gè)核心文件。

process.chdir(directory)

為進(jìn)程改變當(dāng)前工作目錄，如果失敗，則拋出一個(gè)異常。

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

process.cwd()

返回進(jìn)程的當(dāng)前工作目錄。

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

process.env

包含用戶環(huán)境變量的對象。參閱environ(7)。

一個(gè)例子：

{ 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/iojs' }

你可以改寫這個(gè)對象，但是改變不會(huì)反應(yīng)在你的進(jìn)程之外。這以為著以下代碼不會(huì)正常工作：

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

但是以下代碼會(huì)：

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

process.exit([code])

使用指定的退出碼退出程序，如果忽略退出碼。那么將使用“成功”退出碼0。

以一個(gè)“失敗”退出碼結(jié)束：

process.exit(1);

在執(zhí)行io.js的shell中可以看到為1的退出碼。