Latest web development tutorials

Node.js 全局對象

JavaScript 中有一個特殊的對象,稱為全局對象(Global Object),它及其所有屬性都可以在程序的任何地方訪問,即全局變量。

在瀏覽器JavaScript 中,通常window 是全局對象, 而Node.js 中的全局對像是global,所有全局變量(除了global 本身以外)都是global 對象的屬性。

在Node.js 我們可以直接訪問到global 的屬性,而不需要在應用中包含它。


全局對象與全局變量

global 最根本的作用是作為全局變量的宿主。 按照ECMAScript 的定義,滿足以下條件的變量是全局變量:

  • 在最外層定義的變量;
  • 全局對象的屬性;
  • 隱式定義的變量(未定義直接賦值的變量)。

當你定義一個全局變量時,這個變量同時也會成為全局對象的屬性,反之亦然。 需要注意的是,在Node.js 中你不可能在最外層定義變量,因為所有用戶代碼都是屬於當前模塊的, 而模塊本身不是最外層上下文。

注意:永遠使用var定義變量以避免引入全局變量,因為全局變量會污染命名空間,提高代碼的耦合風險。


__filename

__filename表示當前正在執行的腳本的文件名。它將輸出文件所在位置的絕對路徑,且和命令行參數所指定的文件名不一定相同。 如果在模塊中,返回的值是模塊文件的路徑。

實例

創建文件main.js ,代碼如下所示:

// 输出全局变量 __filename 的值
console.log( __filename );

執行main.js 文件,代碼如下所示:

$ node main.js
/web/com/w3big/nodejs/main.js

__dirname

__dirname表示當前執行腳本所在的目錄。

實例

創建文件main.js ,代碼如下所示:

// 输出全局变量 __dirname 的值
console.log( __dirname );

執行main.js 文件,代碼如下所示:

$ node main.js
/web/com/w3big/nodejs

setTimeout(cb, ms)

setTimeout(cb, ms)全局函數在指定的毫秒(ms)數後執行指定函數(cb)。:setTimeout() 只執行一次指定函數。

返回一個代表定時器的句柄值。

實例

創建文件main.js ,代碼如下所示:

function printHello(){
   console.log( "Hello, World!");
}
// 两秒后执行以上函数
setTimeout(printHello, 2000);

執行main.js 文件,代碼如下所示:

$ node main.js
Hello, World!

clearTimeout(t)

clearTimeout( t )全局函數用於停止一個之前通過setTimeout()創建的定時器。參數t是通過setTimeout()函數創建的計算器。

實例

創建文件main.js ,代碼如下所示:

function printHello(){
   console.log( "Hello, World!");
}
// 两秒后执行以上函数
var t = setTimeout(printHello, 2000);

// 清除定时器
clearTimeout(t);

執行main.js 文件,代碼如下所示:

$ node main.js

setInterval(cb, ms)

setInterval(cb, ms)全局函數在指定的毫秒(ms)數後執行指定函數(cb)。

返回一個代表定時器的句柄值。 可以使用clearInterval(t)函數來清除定時器。

setInterval() 方法會不停地調用函數,直到clearInterval() 被調用或窗口被關閉。

實例

創建文件main.js ,代碼如下所示:

function printHello(){
   console.log( "Hello, World!");
}
// 两秒后执行以上函数
setInterval(printHello, 2000);

執行main.js 文件,代碼如下所示:

$ node main.js
Hello, World! Hello, World! Hello, World! Hello, World! Hello, World! ……

以上程序每隔兩秒就會輸出一次"Hello, World!",且會永久執行下去,直到你按下ctrl + c按鈕。


console

console 用於提供控制台標準輸出,它是由Internet Explorer 的JScript 引擎提供的調試工具,後來逐漸成為瀏覽器的事實標準。

Node.js 沿用了這個標準,提供與習慣行為一致的console 對象,用於向標準輸出流(stdout)或標準錯誤流(stderr)輸出字符。

console 方法

以下為console 對象的方法:

序號 方法& 描述
1 console.log([data][, ...])
向標準輸出流打印字符並以換行符結束。 該方法接收若干個參數,如果只有一個參數,則輸出這個參數的字符串形式。 如果有多個參數,則以類似於C 語言printf() 命令的格式輸出。
2 console.info([data][, ...])
P該命令的作用是返回信息性消息,這個命令與console.log差別並不大,除了在chrome中只會輸出文字外,其餘的會顯示一個藍色的驚嘆號。
3 console.error([data][, ...])
輸出錯誤消息的。 控制台在出現錯誤時會顯示是紅色的叉子。
4 console.warn([data][, ...])
輸出警告消息。 控制台出現有黃色的驚嘆號。
5 console.dir(obj[, options])
用來對一個對象進行檢查(inspect),並以易於閱讀和打印的格式顯示。
6 console.time(label)
輸出時間,表示計時開始。
7 console.timeEnd(label)
結束時間,表示計時結束。
8 console.trace(message[, ...])
當前執行的代碼在堆棧中的調用路徑,這個測試函數運行很有幫助,只要給想測試的函數里面加入console.trace 就行了。
9 console.assert(value[, message][, ...])
用於判斷某個表達式或變量是否為真,接手兩個參數,第一個參數是表達式,第二個參數是字符串。 只有當第一個參數為false,才會輸出第二個參數,否則不會有任何結果。
console.log():向標準輸出流打印字符並以換行符結束。

console.log 接受若干個參數,如果只有一個參數,則輸出這個參數的字符串形式。 如果有多個參數,則以類似於C 語言printf() 命令的格式輸出。

第一個參數是一個字符串,如果沒有參數,只打印一個換行。

console.log('Hello world'); 
console.log('byvoid%diovyb'); 
console.log('byvoid%diovyb', 1991); 

運行結果為:

Hello world 
byvoid%diovyb 
byvoid1991iovyb 
  • console.error():與console.log() 用法相同,只是向標準錯誤流輸出。
  • console.trace():向標準錯誤流輸出當前的調用棧。
console.trace();

運行結果為:

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)

實例

創建文件main.js ,代碼如下所示:

console.info("程序开始执行:");

var counter = 10;
console.log("计数: %d", counter);

console.time("获取数据");
//
// 执行一些代码
// 
console.timeEnd('获取数据');

console.info("程序执行完毕。")

執行main.js 文件,代碼如下所示:

$ node main.js
程序开始执行:
计数: 10
获取数据: 0ms
程序执行完毕

process

process 是一個全局變量,即global 對象的屬性。

它用於描述當前Node.js 進程狀態的對象,提供了一個與操作系統的簡單接口。 通常在你寫本地命令行程序的時候,少不了要和它打交道。 下面將會介紹process 對象的一些最常用的成員方法。

序號 事件& 描述
1 exit
當進程準備退出時觸發。
2 beforeExit
當node 清空事件循環,並且沒有其他安排時觸發這個事件。 通常來說,當沒有進程安排時node 退出,但是'beforeExit' 的監聽器可以異步調用,這樣node 就會繼續執行。
3 uncaughtException
當一個異常冒泡回到事件循環,觸發這個事件。 如果給異常添加了監視器,默認的操作(打印堆棧跟踪信息並退出)就不會發生。
4 Signal事件 <br>當進程接收到信號時就觸發。信號列表詳見標準的POSIX 信號名,如SIGINT、SIGUSR1 等。

實例

創建文件main.js ,代碼如下所示:

process.on('exit', function(code) {

  // 以下代码永远不会执行
  setTimeout(function() {
    console.log("该代码不会执行");
  }, 0);
  
  console.log('退出码为:', code);
});
console.log("程序执行结束");

執行main.js 文件,代碼如下所示:

$ node main.js
程序执行结束
退出码为: 0

退出狀態碼

退出狀態碼如下所示:

狀態碼 名稱& 描述
1 Uncaught Fatal Exception
有未捕獲異常,並且沒有被域或uncaughtException 處理函數處理。
2 Unused
保留
3 Internal JavaScript Parse Error
JavaScript的源碼啟動Node 進程時引起解析錯誤。 非常罕見,僅會在開發Node 時才會有。
4 Internal JavaScript Evaluation Failure
JavaScript 的源碼啟動Node 進程,評估時返回函數失敗。 非常罕見,僅會在開發Node 時才會有。
5 Fatal Error
V8 裡致命的不可恢復的錯誤。 通常會打印到stderr ,內容為: FATAL ERROR
6 Non-function Internal Exception Handler
未捕獲異常,內部異常處理函數不知為何設置為on-function,並且不能被調用。
7 Internal Exception Handler Run-Time Failure
未捕獲的異常, 並且異常處理函數處理時自己拋出了異常。 例如,如果process.on('uncaughtException') 或domain.on('error') 拋出了異常。
8 Unused
保留
9 Invalid Argument
可能是給了未知的參數,或者給的參數沒有值。
10 Internal JavaScript Run-Time Failure
JavaScript的源碼啟動Node 進程時拋出錯誤,非常罕見,僅會在開發Node 時才會有。
12 Invalid Debug Argument
設置了參數--debug 和/或--debug-brk,但是選擇了錯誤端口。
>128 Signal Exits
如果Node 接收到致命信號,比如SIGKILL 或SIGHUP,那麼退出代碼就是128 加信號代碼。 這是標準的Unix 做法,退出信號代碼放在高位。

Process 屬性

Process 提供了很多有用的屬性,便於我們更好的控制系統的交互:

序號. 屬性& 描述
1 stdout
標準輸出流。
2 stderr
標準錯誤流。
3 stdin
標準輸入流。
4 argv
argv 屬性返回一個數組,由命令行執行腳本時的各個參數組成。 它的第一個成員總是node,第二個成員是腳本文件名,其餘成員是腳本文件的參數。
5 execPath
返回執行當前腳本的Node 二進製文件的絕對路徑。
6 execArgv
返回一個數組,成員是命令行下執行腳本時,在Node可執行文件與腳本文件之間的命令行參數。
7 env
返回一個對象,成員為當前shell 的環境變量
8 exitCode
進程退出時的代碼,如果進程優通過process.exit() 退出,不需要指定退出碼。
9 version
Node 的版本,比如v0.10.18。
10 versions
一個屬性,包含了node 的版本和依賴.
11 config
一個包含用來編譯當前node 執行文件的javascript 配置選項的對象。 它與運行./configure 腳本生成的"config.gypi" 文件相同。
12 pid
當前進程的進程號。
13 title
進程名,默認值為"node",可以自定義該值。
14 arch
當前CPU 的架構:'arm'、'ia32' 或者'x64'。
15 platform
運行程序所在的平台系統'darwin', 'freebsd', 'linux', 'sunos' 或'win32'
16 mainModule
require.main 的備選方法。 不同點,如果主模塊在運行時改變,require.main可能會繼續返回老的模塊。 可以認為,這兩者引用了同一個模塊。

實例

創建文件main.js ,代碼如下所示:

// 输出到终端
process.stdout.write("Hello World!" + "\n");

// 通过参数读取
process.argv.forEach(function(val, index, array) {
   console.log(index + ': ' + val);
});

// 获取执行路局
console.log(process.execPath);


// 平台信息
console.log(process.platform);

執行main.js 文件,代碼如下所示:

$ node main.js
Hello World!
0: node
1: /web/www/node/main.js
/usr/local/node/0.10.36/bin/node
darwin

方法參考手冊

Process 提供了很多有用的方法,便於我們更好的控制系統的交互:

序號 方法& 描述
1 abort()
這將導致node 觸發abort 事件。 會讓node 退出並生成一個核心文件。
2 chdir(directory)
改變當前工作進程的目錄,如果操作失敗拋出異常。
3 cwd()
返回當前進程的工作目錄
4 exit([code])
使用指定的code 結束進程。 如果忽略,將會使用code 0。
5 getgid()
獲取進程的群組標識(參見getgid(2))。 獲取到得時群組的數字id,而不是名字。
注意:這個函數僅在POSIX 平台上可用(例如,非Windows 和Android)。
6 setgid(id)
設置進程的群組標識(參見setgid(2))。 可以接收數字ID 或者群組名。 如果指定了群組名,會阻塞等待解析為數字ID 。
注意:這個函數僅在POSIX 平台上可用(例如,非Windows 和Android)。
7 getuid()
獲取進程的用戶標識(參見getuid(2))。 這是數字的用戶id,不是用戶名。
注意:這個函數僅在POSIX 平台上可用(例如,非Windows 和Android)。
8 setuid(id)
設置進程的用戶標識(參見setuid(2))。 接收數字ID或字符串名字。 果指定了群組名,會阻塞等待解析為數字ID 。
注意:這個函數僅在POSIX 平台上可用(例如,非Windows 和Android)。
9 getgroups()
返回進程的群組iD 數組。 POSIX 系統沒有保證一定有,但是node.js 保證有。
注意:這個函數僅在POSIX 平台上可用(例如,非Windows 和Android)。
10 setgroups(groups)
設置進程的群組ID。 這是授權操作,所有你需要有root 權限,或者有CAP_SETGID 能力。
注意:這個函數僅在POSIX 平台上可用(例如,非Windows 和Android)。
11 initgroups(user, extra_group)
讀取/etc/group ,並初始化群組訪問列表,使用成員所在的所有群組。 這是授權操作,所有你需要有root 權限,或者有CAP_SETGID 能力。
注意:這個函數僅在POSIX 平台上可用(例如,非Windows 和Android)。
12 kill(pid[, signal])
發送信號給進程. pid 是進程id,並且signal 是發送的信號的字符串描述。 信號名是字符串,比如'SIGINT' 或'SIGHUP'。 如果忽略,信號會是'SIGTERM'。
13 memoryUsage()
返回一個對象,描述了Node 進程所用的內存狀況,單位為字節。
14 nextTick(callback)
一旦當前事件循環結束,調用回到函數。
15 umask([mask])
設置或讀取進程文件的掩碼。 子進程從父進程繼承掩碼。 如果mask 參數有效,返回舊的掩碼。 否則,返回當前掩碼。
16 uptime()
返回Node 已經運行的秒數。
17 hrtime()
返回當前進程的高分辨時間,形式​​為[seconds, nanoseconds]數組。 它是相對於過去的任意事件。 該值與日期無關,因此不受時鐘漂移的影響。 主要用途是可以通過精確的時間間隔,來衡量程序的性能。
你可以將之前的結果傳遞給當前的process.hrtime() ,會返回兩者間的時間差,用來基準和測量時間間隔。

實例

創建文件main.js ,代碼如下所示:

// 输出当前目录
console.log('当前目录: ' + process.cwd());

// 输出当前版本
console.log('当前版本: ' + process.version);

// 输出内存使用情况
console.log(process.memoryUsage());

執行main.js 文件,代碼如下所示:

$ node main.js
当前目录: /web/com/w3big/nodejs
当前版本: v0.10.36
{ rss: 12541952, heapTotal: 4083456, heapUsed: 2157056 }