閱讀(33.8k) 書簽贊(0) 我要糾錯

IO.js Process

2018-11-28 22:34 更新

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

Exit Codes

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

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

Event: 'exit'

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

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

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

Event: 'uncaughtException'

當一個異常冒泡回事件循環(huán)時就會觸發(fā)。如果這個時間被添加了監(jiān)聽器，那么默認行為（退出程序且打印堆棧跟蹤信息）將不會發(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)使用了它，請在不處理這個異常之后重啟你的應(yīng)用。

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

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

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

Event: 'unhandledRejection'

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

reason promise的“拒絕”對象（通常是一個錯誤實例）
p 被“拒絕”的promise

下面是一個把所有未處理的“拒絕”打印到控制臺的例子：

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

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

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

Event: 'rejectionHandled'

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

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

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

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

使用“拒絕”偵測鉤子來保持一個被“拒絕”的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

當一個進程收到一個信號時觸發(fā)。參閱sigaction(2)。

監(jiān)聽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.');
});

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

注意：

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

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

process.stdout

一個指向stdout的可寫流。

例如，console.log可能與這個相似：

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

在io.js中，process.stderr和process.stdout與其他流不同，因為他們不能被關(guān)閉（調(diào)用end()會報錯）。它們永遠不觸發(fā)finish事件并且寫操作通常是阻塞的。

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

若要檢查io.js是否在一個TTY上下文中運行，讀取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

一個指向stderr的可寫流。

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

process.stdin

一個指向stdin的可讀流。

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

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可以被切換至“舊”模式，這樣就可以兼容node.js v0.10 前所寫的腳本。更多信息請參閱流的兼容性。

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

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

process.argv

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

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

這將會是：

$ 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

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

例子：

/usr/local/bin/iojs

process.execArgv

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

例子：

$ iojs --harmony script.js --version

process.execArgv將會是：

['--harmony']

process.argv將會是：

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

process.abort()

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

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

包含用戶環(huán)境變量的對象。參閱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/iojs' }

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

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

但是以下代碼會：

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

process.exit([code])

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

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

process.exit(1);

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