Node.js 全局對(duì)象
JavaScript 中有一個(gè)特殊的對(duì)象,稱為全局對(duì)象(Global Object),它及其所有屬性都可以在程序的任何地方訪問,即全局變量。
在瀏覽器 JavaScript 中,通常 window 是全局對(duì)象, 而 Node.js 中的全局對(duì)象是 global,所有全局變量(除了 global 本身以外)都是 global 對(duì)象的屬性。
在 Node.js 我們可以直接訪問到 global 的屬性,而不需要在應(yīng)用中包含它。
全局對(duì)象與全局變量
global 最根本的作用是作為全局變量的宿主。按照 ECMAScript 的定義,滿足以下條 件的變量是全局變量:
在最外層定義的變量;
全局對(duì)象的屬性;
隱式定義的變量(未定義直接賦值的變量)。
當(dāng)你定義一個(gè)全局變量時(shí),這個(gè)變量同時(shí)也會(huì)成為全局對(duì)象的屬性,反之亦然。需要注 意的是,在 Node.js 中你不可能在最外層定義變量,因?yàn)樗杏脩舸a都是屬于當(dāng)前模塊的, 而模塊本身不是最外層上下文。
注意:永遠(yuǎn)使用 var 定義變量以避免引入全局變量,因?yàn)槿肿兞繒?huì)污染 命名空間,提高代碼的耦合風(fēng)險(xiǎn)。
__filename
__filename 表示當(dāng)前正在執(zhí)行的腳本的文件名。它將輸出文件所在位置的絕對(duì)路徑,且和命令行參數(shù)所指定的文件名不一定相同。 如果在模塊中,返回的值是模塊文件的路徑。
實(shí)例
創(chuàng)建文件 main.js ,代碼如下所示:
// 輸出全局變量 __filename 的值 console.log( __filename );
執(zhí)行 main.js 文件,代碼如下所示:
$ node main.js /web/com/php/nodejs/main.js
__dirname
__dirname 表示當(dāng)前執(zhí)行腳本所在的目錄。
實(shí)例
創(chuàng)建文件 main.js ,代碼如下所示:
// 輸出全局變量 __dirname 的值 console.log( __dirname );
執(zhí)行 main.js 文件,代碼如下所示:
$ node main.js /web/com/php/nodejs
setTimeout(cb, ms)
setTimeout(cb, ms) 全局函數(shù)在指定的毫秒(ms)數(shù)后執(zhí)行指定函數(shù)(cb)。:setTimeout() 只執(zhí)行一次指定函數(shù)。
返回一個(gè)代表定時(shí)器的句柄值。
實(shí)例
創(chuàng)建文件 main.js ,代碼如下所示:
function printHello(){ console.log( "Hello, World!"); } // 兩秒后執(zhí)行以上函數(shù) setTimeout(printHello, 2000);
執(zhí)行 main.js 文件,代碼如下所示:
$ node main.js Hello, World!
clearTimeout(t)
clearTimeout( t ) 全局函數(shù)用于停止一個(gè)之前通過 setTimeout() 創(chuàng)建的定時(shí)器。 參數(shù) t 是通過 setTimeout() 函數(shù)創(chuàng)建的計(jì)算器。
實(shí)例
創(chuàng)建文件 main.js ,代碼如下所示:
function printHello(){ console.log( "Hello, World!"); } // 兩秒后執(zhí)行以上函數(shù) var t = setTimeout(printHello, 2000); // 清除定時(shí)器 clearTimeout(t);
執(zhí)行 main.js 文件,代碼如下所示:
$ node main.js
setInterval(cb, ms)
setInterval(cb, ms) 全局函數(shù)在指定的毫秒(ms)數(shù)后執(zhí)行指定函數(shù)(cb)。
返回一個(gè)代表定時(shí)器的句柄值。可以使用 clearInterval(t) 函數(shù)來清除定時(shí)器。
setInterval() 方法會(huì)不停地調(diào)用函數(shù),直到 clearInterval() 被調(diào)用或窗口被關(guān)閉。
實(shí)例
創(chuàng)建文件 main.js ,代碼如下所示:
function printHello(){ console.log( "Hello, World!"); } // 兩秒后執(zhí)行以上函數(shù) setInterval(printHello, 2000);
執(zhí)行 main.js 文件,代碼如下所示:
$ node main.jsHello, World! Hello, World! Hello, World! Hello, World! Hello, World! ……
以上程序每隔兩秒就會(huì)輸出一次"Hello, World!",且會(huì)永久執(zhí)行下去,直到你按下 ctrl + c 按鈕。
console
console 用于提供控制臺(tái)標(biāo)準(zhǔn)輸出,它是由 Internet Explorer 的 JScript 引擎提供的調(diào)試工具,后來逐漸成為瀏覽器的事實(shí)標(biāo)準(zhǔn)。
Node.js 沿用了這個(gè)標(biāo)準(zhǔn),提供與習(xí)慣行為一致的 console 對(duì)象,用于向標(biāo)準(zhǔn)輸出流(stdout)或標(biāo)準(zhǔn)錯(cuò)誤流(stderr)輸出字符。
console 方法
以下為 console 對(duì)象的方法:
序號(hào) | 方法 & 描述 |
---|---|
1 | console.log([data][, ...]) 向標(biāo)準(zhǔn)輸出流打印字符并以換行符結(jié)束。該方法接收若干 個(gè)參數(shù),如果只有一個(gè)參數(shù),則輸出這個(gè)參數(shù)的字符串形式。如果有多個(gè)參數(shù),則 以類似于C 語言 printf() 命令的格式輸出。 |
2 | console.info([data][, ...]) P該命令的作用是返回信息性消息,這個(gè)命令與console.log差別并不大,除了在chrome中只會(huì)輸出文字外,其余的會(huì)顯示一個(gè)藍(lán)色的驚嘆號(hào)。 |
3 | console.error([data][, ...]) 輸出錯(cuò)誤消息的??刂婆_(tái)在出現(xiàn)錯(cuò)誤時(shí)會(huì)顯示是紅色的叉子。 |
4 | console.warn([data][, ...]) 輸出警告消息??刂婆_(tái)出現(xiàn)有黃色的驚嘆號(hào)。 |
5 | console.dir(obj[, options]) 用來對(duì)一個(gè)對(duì)象進(jìn)行檢查(inspect),并以易于閱讀和打印的格式顯示。 |
6 | console.time(label) 輸出時(shí)間,表示計(jì)時(shí)開始。 |
7 | console.timeEnd(label) 結(jié)束時(shí)間,表示計(jì)時(shí)結(jié)束。 |
8 | console.trace(message[, ...]) 當(dāng)前執(zhí)行的代碼在堆棧中的調(diào)用路徑,這個(gè)測(cè)試函數(shù)運(yùn)行很有幫助,只要給想測(cè)試的函數(shù)里面加入 console.trace 就行了。 |
9 | console.assert(value[, message][, ...]) 用于判斷某個(gè)表達(dá)式或變量是否為真,接手兩個(gè)參數(shù),第一個(gè)參數(shù)是表達(dá)式,第二個(gè)參數(shù)是字符串。只有當(dāng)?shù)谝粋€(gè)參數(shù)為false,才會(huì)輸出第二個(gè)參數(shù),否則不會(huì)有任何結(jié)果。 |
console.log 接受若干 個(gè)參數(shù),如果只有一個(gè)參數(shù),則輸出這個(gè)參數(shù)的字符串形式。如果有多個(gè)參數(shù),則 以類似于C 語言 printf() 命令的格式輸出。
第一個(gè)參數(shù)是一個(gè)字符串,如果沒有 參數(shù),只打印一個(gè)換行。
console.log('Hello world'); console.log('byvoid%diovyb'); console.log('byvoid%diovyb', 1991);
運(yùn)行結(jié)果為:
Hello world byvoid%diovyb byvoid1991iovyb
console.error():與console.log() 用法相同,只是向標(biāo)準(zhǔn)錯(cuò)誤流輸出。
console.trace():向標(biāo)準(zhǔn)錯(cuò)誤流輸出當(dāng)前的調(diào)用棧。
console.trace();
運(yùn)行結(jié)果為:
Trace: at Object.<anonymous> (/home/byvoid/consoletrace.js:1:71) at Module._compile (module.js:441:26) at Object..js (module.js:459:10) at Module.load (module.js:348:31) at Function._load (module.js:308:12) at Array.0 (module.js:479:10) at EventEmitter._tickCallback (node.js:192:40)
實(shí)例
創(chuàng)建文件 main.js ,代碼如下所示:
console.info("程序開始執(zhí)行:"); var counter = 10; console.log("計(jì)數(shù): %d", counter); console.time("獲取數(shù)據(jù)"); // // 執(zhí)行一些代碼 // console.timeEnd('獲取數(shù)據(jù)'); console.info("程序執(zhí)行完畢。")
執(zhí)行 main.js 文件,代碼如下所示:
$ node main.js 程序開始執(zhí)行: 計(jì)數(shù): 10 獲取數(shù)據(jù): 0ms 程序執(zhí)行完畢
process
process 是一個(gè)全局變量,即 global 對(duì)象的屬性。
它用于描述當(dāng)前Node.js 進(jìn)程狀態(tài)的對(duì)象,提供了一個(gè)與操作系統(tǒng)的簡(jiǎn)單接口。通常在你寫本地命令行程序的時(shí)候,少不了要 和它打交道。下面將會(huì)介紹 process 對(duì)象的一些最常用的成員方法。
序號(hào) | 事件 & 描述 |
---|---|
1 | exit 當(dāng)進(jìn)程準(zhǔn)備退出時(shí)觸發(fā)。 |
2 | beforeExit 當(dāng) node 清空事件循環(huán),并且沒有其他安排時(shí)觸發(fā)這個(gè)事件。通常來說,當(dāng)沒有進(jìn)程安排時(shí) node 退出,但是 'beforeExit' 的監(jiān)聽器可以異步調(diào)用,這樣 node 就會(huì)繼續(xù)執(zhí)行。 |
3 | uncaughtException 當(dāng)一個(gè)異常冒泡回到事件循環(huán),觸發(fā)這個(gè)事件。如果給異常添加了監(jiān)視器,默認(rèn)的操作(打印堆棧跟蹤信息并退出)就不會(huì)發(fā)生。 |
4 | Signal 事件 當(dāng)進(jìn)程接收到信號(hào)時(shí)就觸發(fā)。信號(hào)列表詳見標(biāo)準(zhǔn)的 POSIX 信號(hào)名,如 SIGINT、SIGUSR1 等。 |
實(shí)例
創(chuàng)建文件 main.js ,代碼如下所示:
process.on('exit', function(code) { // 以下代碼永遠(yuǎn)不會(huì)執(zhí)行 setTimeout(function() { console.log("該代碼不會(huì)執(zhí)行"); }, 0); console.log('退出碼為:', code); }); console.log("程序執(zhí)行結(jié)束");
執(zhí)行 main.js 文件,代碼如下所示:
$ node main.js 程序執(zhí)行結(jié)束 退出碼為: 0
退出狀態(tài)碼
退出狀態(tài)碼如下所示:
狀態(tài)碼 | 名稱 & 描述 |
---|---|
1 | Uncaught Fatal Exception 有未捕獲異常,并且沒有被域或 uncaughtException 處理函數(shù)處理。 |
2 | Unused 保留 |
3 | Internal JavaScript Parse Error JavaScript的源碼啟動(dòng) Node 進(jìn)程時(shí)引起解析錯(cuò)誤。非常罕見,僅會(huì)在開發(fā) Node 時(shí)才會(huì)有。 |
4 | Internal JavaScript Evaluation Failure JavaScript 的源碼啟動(dòng) Node 進(jìn)程,評(píng)估時(shí)返回函數(shù)失敗。非常罕見,僅會(huì)在開發(fā) Node 時(shí)才會(huì)有。 |
5 | Fatal Error V8 里致命的不可恢復(fù)的錯(cuò)誤。通常會(huì)打印到 stderr ,內(nèi)容為: FATAL ERROR |
6 | Non-function Internal Exception Handler 未捕獲異常,內(nèi)部異常處理函數(shù)不知為何設(shè)置為on-function,并且不能被調(diào)用。 |
7 | Internal Exception Handler Run-Time Failure 未捕獲的異常, 并且異常處理函數(shù)處理時(shí)自己拋出了異常。例如,如果 process.on('uncaughtException') 或 domain.on('error') 拋出了異常。 |
8 | Unused 保留 |
9 | Invalid Argument 可能是給了未知的參數(shù),或者給的參數(shù)沒有值。 |
10 | Internal JavaScript Run-Time Failure JavaScript的源碼啟動(dòng) Node 進(jìn)程時(shí)拋出錯(cuò)誤,非常罕見,僅會(huì)在開發(fā) Node 時(shí)才會(huì)有。 |
12 | Invalid Debug Argument 設(shè)置了參數(shù)--debug 和/或 --debug-brk,但是選擇了錯(cuò)誤端口。 |
>128 | Signal Exits 如果 Node 接收到致命信號(hào),比如SIGKILL 或 SIGHUP,那么退出代碼就是128 加信號(hào)代碼。這是標(biāo)準(zhǔn)的 Unix 做法,退出信號(hào)代碼放在高位。 |
Process 屬性
Process 提供了很多有用的屬性,便于我們更好的控制系統(tǒng)的交互:
序號(hào). | 屬性 & 描述 |
---|---|
1 | stdout 標(biāo)準(zhǔn)輸出流。 |
2 | stderr 標(biāo)準(zhǔn)錯(cuò)誤流。 |
3 | stdin 標(biāo)準(zhǔn)輸入流。 |
4 | argv argv 屬性返回一個(gè)數(shù)組,由命令行執(zhí)行腳本時(shí)的各個(gè)參數(shù)組成。它的第一個(gè)成員總是node,第二個(gè)成員是腳本文件名,其余成員是腳本文件的參數(shù)。 |
5 | execPath 返回執(zhí)行當(dāng)前腳本的 Node 二進(jìn)制文件的絕對(duì)路徑。 |
6 | execArgv 返回一個(gè)數(shù)組,成員是命令行下執(zhí)行腳本時(shí),在Node可執(zhí)行文件與腳本文件之間的命令行參數(shù)。 |
7 | env 返回一個(gè)對(duì)象,成員為當(dāng)前 shell 的環(huán)境變量 |
8 | exitCode 進(jìn)程退出時(shí)的代碼,如果進(jìn)程優(yōu)通過 process.exit() 退出,不需要指定退出碼。 |
9 | version Node 的版本,比如v0.10.18。 |
10 | versions 一個(gè)屬性,包含了 node 的版本和依賴. |
11 | config 一個(gè)包含用來編譯當(dāng)前 node 執(zhí)行文件的 javascript 配置選項(xiàng)的對(duì)象。它與運(yùn)行 ./configure 腳本生成的 "config.gypi" 文件相同。 |
12 | pid 當(dāng)前進(jìn)程的進(jìn)程號(hào)。 |
13 | title 進(jìn)程名,默認(rèn)值為"node",可以自定義該值。 |
14 | arch 當(dāng)前 CPU 的架構(gòu):'arm'、'ia32' 或者 'x64'。 |
15 | platform 運(yùn)行程序所在的平臺(tái)系統(tǒng) 'darwin', 'freebsd', 'linux', 'sunos' 或 'win32' |
16 | mainModule require.main 的備選方法。不同點(diǎn),如果主模塊在運(yùn)行時(shí)改變,require.main可能會(huì)繼續(xù)返回老的模塊??梢哉J(rèn)為,這兩者引用了同一個(gè)模塊。 |
實(shí)例
創(chuàng)建文件 main.js ,代碼如下所示:
// 輸出到終端 process.stdout.write("Hello World!" + "\n"); // 通過參數(shù)讀取 process.argv.forEach(function(val, index, array) { console.log(index + ': ' + val); }); // 獲取執(zhí)行路局 console.log(process.execPath); // 平臺(tái)信息 console.log(process.platform);
執(zhí)行 main.js 文件,代碼如下所示:
$ node main.js Hello World! 0: node 1: /web/www/node/main.js /usr/local/node/0.10.36/bin/node darwin
方法參考手冊(cè)
Process 提供了很多有用的方法,便于我們更好的控制系統(tǒng)的交互:
序號(hào) | 方法 & 描述 |
---|---|
1 | abort() 這將導(dǎo)致 node 觸發(fā) abort 事件。會(huì)讓 node 退出并生成一個(gè)核心文件。 |
2 | chdir(directory) 改變當(dāng)前工作進(jìn)程的目錄,如果操作失敗拋出異常。 |
3 | cwd() 返回當(dāng)前進(jìn)程的工作目錄 |
4 | exit([code]) 使用指定的 code 結(jié)束進(jìn)程。如果忽略,將會(huì)使用 code 0。 |
5 | getgid() 獲取進(jìn)程的群組標(biāo)識(shí)(參見 getgid(2))。獲取到得時(shí)群組的數(shù)字 id,而不是名字。 注意:這個(gè)函數(shù)僅在 POSIX 平臺(tái)上可用(例如,非Windows 和 Android)。 |
6 | setgid(id) 設(shè)置進(jìn)程的群組標(biāo)識(shí)(參見 setgid(2))??梢越邮諗?shù)字 ID 或者群組名。如果指定了群組名,會(huì)阻塞等待解析為數(shù)字 ID 。 注意:這個(gè)函數(shù)僅在 POSIX 平臺(tái)上可用(例如,非Windows 和 Android)。 |
7 | getuid() 獲取進(jìn)程的用戶標(biāo)識(shí)(參見 getuid(2))。這是數(shù)字的用戶 id,不是用戶名。 注意:這個(gè)函數(shù)僅在 POSIX 平臺(tái)上可用(例如,非Windows 和 Android)。 |
8 | setuid(id) 設(shè)置進(jìn)程的用戶標(biāo)識(shí)(參見setuid(2))。接收數(shù)字 ID或字符串名字。果指定了群組名,會(huì)阻塞等待解析為數(shù)字 ID 。 注意:這個(gè)函數(shù)僅在 POSIX 平臺(tái)上可用(例如,非Windows 和 Android)。 |
9 | getgroups() 返回進(jìn)程的群組 iD 數(shù)組。POSIX 系統(tǒng)沒有保證一定有,但是 node.js 保證有。 注意:這個(gè)函數(shù)僅在 POSIX 平臺(tái)上可用(例如,非Windows 和 Android)。 |
10 | setgroups(groups) 設(shè)置進(jìn)程的群組 ID。這是授權(quán)操作,所有你需要有 root 權(quán)限,或者有 CAP_SETGID 能力。 注意:這個(gè)函數(shù)僅在 POSIX 平臺(tái)上可用(例如,非Windows 和 Android)。 |
11 | initgroups(user, extra_group) 讀取 /etc/group ,并初始化群組訪問列表,使用成員所在的所有群組。這是授權(quán)操作,所有你需要有 root 權(quán)限,或者有 CAP_SETGID 能力。 注意:這個(gè)函數(shù)僅在 POSIX 平臺(tái)上可用(例如,非Windows 和 Android)。 |
12 | kill(pid[, signal]) 發(fā)送信號(hào)給進(jìn)程. pid 是進(jìn)程id,并且 signal 是發(fā)送的信號(hào)的字符串描述。信號(hào)名是字符串,比如 'SIGINT' 或 'SIGHUP'。如果忽略,信號(hào)會(huì)是 'SIGTERM'。 |
13 | memoryUsage() 返回一個(gè)對(duì)象,描述了 Node 進(jìn)程所用的內(nèi)存狀況,單位為字節(jié)。 |
14 | nextTick(callback) 一旦當(dāng)前事件循環(huán)結(jié)束,調(diào)用回到函數(shù)。 |
15 | umask([mask]) 設(shè)置或讀取進(jìn)程文件的掩碼。子進(jìn)程從父進(jìn)程繼承掩碼。如果mask 參數(shù)有效,返回舊的掩碼。否則,返回當(dāng)前掩碼。 |
16 | uptime() 返回 Node 已經(jīng)運(yùn)行的秒數(shù)。 |
17 | hrtime() 返回當(dāng)前進(jìn)程的高分辨時(shí)間,形式為 [seconds, nanoseconds]數(shù)組。它是相對(duì)于過去的任意事件。該值與日期無關(guān),因此不受時(shí)鐘漂移的影響。主要用途是可以通過精確的時(shí)間間隔,來衡量程序的性能。 你可以將之前的結(jié)果傳遞給當(dāng)前的 process.hrtime() ,會(huì)返回兩者間的時(shí)間差,用來基準(zhǔn)和測(cè)量時(shí)間間隔。 |
實(shí)例
創(chuàng)建文件 main.js ,代碼如下所示:
// 輸出當(dāng)前目錄 console.log('當(dāng)前目錄: ' + process.cwd()); // 輸出當(dāng)前版本 console.log('當(dāng)前版本: ' + process.version); // 輸出內(nèi)存使用情況 console.log(process.memoryUsage());
執(zhí)行 main.js 文件,代碼如下所示:
$ node main.js 當(dāng)前目錄: /web/com/php/nodejs 當(dāng)前版本: v0.10.36 { rss: 12541952, heapTotal: 4083456, heapUsed: 2157056 }