Node.js 概述

簡(jiǎn)介

Node是JavaScript語(yǔ)言的服務(wù)器運(yùn)行環(huán)境。所謂“運(yùn)行環(huán)境”有兩層意思：首先，JavaScript語(yǔ)言通過Node在服務(wù)器運(yùn)行，在這個(gè)意義上，Node有點(diǎn)像JavaScript虛擬機(jī)；其次，Node提供大量工具庫(kù)，使得JavaScript語(yǔ)言與操作系統(tǒng)互動(dòng)（比如讀寫文件、新建子進(jìn)程），在這個(gè)意義上，Node又是JavaScript的工具庫(kù)。

Node內(nèi)部采用Google公司的V8引擎，作為JavaScript語(yǔ)言解釋器；通過自行開發(fā)的libuv庫(kù)，調(diào)用操作系統(tǒng)資源。

安裝與更新

訪問官方網(wǎng)站nodejs.org了解安裝細(xì)節(jié)。

安裝完成以后，運(yùn)行下面的命令，查看是否能正常運(yùn)行。

$ node --version
# 或者
$ node -v

更新node.js版本，可以通過node.js的n模塊完成。

$ sudo npm install n -g
$ sudo n stable

上面代碼通過n模塊，將node.js更新為最新發(fā)布的穩(wěn)定版。

n模塊也可以指定安裝特定版本的node。

$ sudo n 0.10.21

版本管理工具nvm

如果想在同一臺(tái)機(jī)器，同時(shí)安裝多個(gè)版本的node.js，就需要用到版本管理工具nvm。

$ git clone https://github.com/creationix/nvm.git ~/.nvm
$ source ~/.nvm/nvm.sh

安裝以后，nvm的執(zhí)行腳本，每次使用前都要激活，建議將其加入~/.bashrc文件（假定使用Bash）。激活后，就可以安裝指定版本的Node。

# 安裝最新版本
$ nvm install node

# 安裝指定版本
$ nvm install 0.12.1

# 使用已安裝的最新版本
$ nvm use node

# 使用指定版本的node
$ nvm use 0.12

nvm也允許進(jìn)入指定版本的REPL環(huán)境。

$ nvm run 0.12

如果在項(xiàng)目根目錄下新建一個(gè).nvmrc文件，將版本號(hào)寫入其中，就只輸入nvm use命令即可，不再需要附加版本號(hào)。

下面是其他經(jīng)常用到的命令。

# 查看本地安裝的所有版本
$ nvm ls

# 查看服務(wù)器上所有可供安裝的版本。
$ nvm ls-remote

# 退出已經(jīng)激活的nvm，使用deactivate命令。
$ nvm deactivate

基本用法

安裝完成后，運(yùn)行node.js程序，就是使用node命令讀取JavaScript腳本。

假定當(dāng)前目錄有一個(gè)demo.js的腳本文件，運(yùn)行時(shí)這樣寫。

node demo

// 或者

node demo.js

REPL環(huán)境

在命令行鍵入node命令，后面沒有文件名，就進(jìn)入一個(gè)Node.js的REPL環(huán)境（Read–eval–print loop，"讀取-求值-輸出"循環(huán)），可以直接運(yùn)行各種JavaScript命令。

$ node
> 1+1
2
>

如果使用參數(shù) --use_strict，則REPL將在嚴(yán)格模式下運(yùn)行。

$ node --use_strict

REPL是Node.js與用戶互動(dòng)的shell，各種基本的shell功能都可以在里面使用，比如使用上下方向鍵遍歷曾經(jīng)使用過的命令。

特殊變量下劃線（_）表示上一個(gè)命令的返回結(jié)果。

> 1+1
2
> _+1
3

在REPL中，如果運(yùn)行一個(gè)表達(dá)式，會(huì)直接在命令行返回結(jié)果。如果運(yùn)行一條語(yǔ)句，就不會(huì)有任何輸出，因?yàn)檎Z(yǔ)句沒有返回值。

> x = 1
1
> var x = 1

上面代碼的第二條命令，沒有顯示任何結(jié)果。因?yàn)檫@是一條語(yǔ)句，不是表達(dá)式，所以沒有返回值。

異步操作

Node采用V8引擎處理JavaScript腳本，最大特點(diǎn)就是單線程運(yùn)行，一次只能運(yùn)行一個(gè)任務(wù)。這導(dǎo)致Node大量采用異步操作（asynchronous opertion），即任務(wù)不是馬上執(zhí)行，而是插在任務(wù)隊(duì)列的尾部，等到前面的任務(wù)運(yùn)行完后再執(zhí)行。

由于這種特性，某一個(gè)任務(wù)的后續(xù)操作，往往采用回調(diào)函數(shù)（callback）的形式進(jìn)行定義。

var isTrue = function(value, callback) {
  if (value === true) {
    callback(null, "Value was true.");
  }
  else {
    callback(new Error("Value is not true!"));
  }
}

上面代碼就把進(jìn)一步的處理，交給回調(diào)函數(shù)callback。

Node約定，如果某個(gè)函數(shù)需要回調(diào)函數(shù)作為參數(shù)，則回調(diào)函數(shù)是最后一個(gè)參數(shù)。另外，回調(diào)函數(shù)本身的第一個(gè)參數(shù)，約定為上一步傳入的錯(cuò)誤對(duì)象。

var callback = function (error, value) {
  if (error) {
    return console.log(error);
  }
  console.log(value);
}

上面代碼中，callback的第一個(gè)參數(shù)是Error對(duì)象，第二個(gè)參數(shù)才是真正的數(shù)據(jù)參數(shù)。這是因?yàn)榛卣{(diào)函數(shù)主要用于異步操作，當(dāng)回調(diào)函數(shù)運(yùn)行時(shí)，前期的操作早結(jié)束了，錯(cuò)誤的執(zhí)行棧早就不存在了，傳統(tǒng)的錯(cuò)誤捕捉機(jī)制try...catch對(duì)于異步操作行不通，所以只能把錯(cuò)誤交給回調(diào)函數(shù)處理。

try {
  db.User.get(userId, function(err, user) {
    if(err) {
      throw err
    }
    // ...
  })
} catch(e) {
  console.log(‘Oh no!’);
}

上面代碼中，db.User.get方法是一個(gè)異步操作，等到拋出錯(cuò)誤時(shí)，可能它所在的try...catch代碼塊早就運(yùn)行結(jié)束了，這會(huì)導(dǎo)致錯(cuò)誤無(wú)法被捕捉。所以，Node統(tǒng)一規(guī)定，一旦異步操作發(fā)生錯(cuò)誤，就把錯(cuò)誤對(duì)象傳遞到回調(diào)函數(shù)。

如果沒有發(fā)生錯(cuò)誤，回調(diào)函數(shù)的第一個(gè)參數(shù)就傳入null。這種寫法有一個(gè)很大的好處，就是說(shuō)只要判斷回調(diào)函數(shù)的第一個(gè)參數(shù)，就知道有沒有出錯(cuò)，如果不是null，就肯定出錯(cuò)了。另外，這樣還可以層層傳遞錯(cuò)誤。

if(err) {
  // 除了放過No Permission錯(cuò)誤意外，其他錯(cuò)誤傳給下一個(gè)回調(diào)函數(shù)
  if(!err.noPermission) {
    return next(err);
  }
}

全局對(duì)象和全局變量

Node提供以下幾個(gè)全局對(duì)象，它們是所有模塊都可以調(diào)用的。

• global：表示Node所在的全局環(huán)境，類似于瀏覽器的window對(duì)象。需要注意的是，如果在瀏覽器中聲明一個(gè)全局變量，實(shí)際上是聲明了一個(gè)全局對(duì)象的屬性，比如var x = 1等同于設(shè)置window.x = 1，但是Node不是這樣，至少在模塊中不是這樣（REPL環(huán)境的行為與瀏覽器一致）。在模塊文件中，聲明var x = 1，該變量不是global對(duì)象的屬性，global.x等于undefined。這是因?yàn)槟K的全局變量都是該模塊私有的，其他模塊無(wú)法取到。

• process：該對(duì)象表示Node所處的當(dāng)前進(jìn)程，允許開發(fā)者與該進(jìn)程互動(dòng)。

• console：指向Node內(nèi)置的console模塊，提供命令行環(huán)境中的標(biāo)準(zhǔn)輸入、標(biāo)準(zhǔn)輸出功能。

Node還提供一些全局函數(shù)。

• setTimeout()：用于在指定毫秒之后，運(yùn)行回調(diào)函數(shù)。實(shí)際的調(diào)用間隔，還取決于系統(tǒng)因素。間隔的毫秒數(shù)在1毫秒到2,147,483,647毫秒（約24.8天）之間。如果超過這個(gè)范圍，會(huì)被自動(dòng)改為1毫秒。該方法返回一個(gè)整數(shù)，代表這個(gè)新建定時(shí)器的編號(hào)。
• clearTimeout()：用于終止一個(gè)setTimeout方法新建的定時(shí)器。
• setInterval()：用于每隔一定毫秒調(diào)用回調(diào)函數(shù)。由于系統(tǒng)因素，可能無(wú)法保證每次調(diào)用之間正好間隔指定的毫秒數(shù)，但只會(huì)多于這個(gè)間隔，而不會(huì)少于它。指定的毫秒數(shù)必須是1到2,147,483,647（大約24.8天）之間的整數(shù)，如果超過這個(gè)范圍，會(huì)被自動(dòng)改為1毫秒。該方法返回一個(gè)整數(shù)，代表這個(gè)新建定時(shí)器的編號(hào)。
• clearInterval()：終止一個(gè)用setInterval方法新建的定時(shí)器。
• require()：用于加載模塊。
• Buffer()：用于操作二進(jìn)制數(shù)據(jù)。

Node提供兩個(gè)全局變量，都以兩個(gè)下劃線開頭。

• _filename：指向當(dāng)前運(yùn)行的腳本文件名。
• _dirname：指向當(dāng)前運(yùn)行的腳本所在的目錄。

除此之外，還有一些對(duì)象實(shí)際上是模塊內(nèi)部的局部變量，指向的對(duì)象根據(jù)模塊不同而不同，但是所有模塊都適用，可以看作是偽全局變量，主要為module, module.exports, exports等。

模塊化結(jié)構(gòu)

概述

Node.js采用模塊化結(jié)構(gòu)，按照CommonJS規(guī)范定義和使用模塊。模塊與文件是一一對(duì)應(yīng)關(guān)系，即加載一個(gè)模塊，實(shí)際上就是加載對(duì)應(yīng)的一個(gè)模塊文件。

require命令用于指定加載模塊，加載時(shí)可以省略腳本文件的后綴名。

var circle = require('./circle.js');
// 或者
var circle = require('./circle');

require方法的參數(shù)是模塊文件的名字。它分成兩種情況，第一種情況是參數(shù)中含有文件路徑（比如上例），這時(shí)路徑是相對(duì)于當(dāng)前腳本所在的目錄，第二種情況是參數(shù)中不含有文件路徑，這時(shí)Node到模塊的安裝目錄，去尋找已安裝的模塊（比如下例）。

var bar = require('bar');

有時(shí)候，一個(gè)模塊本身就是一個(gè)目錄，目錄中包含多個(gè)文件。這時(shí)候，Node在package.json文件中，尋找main屬性所指明的模塊入口文件。

{
  "name" : "bar",
  "main" : "./lib/bar.js"
}

上面代碼中，模塊的啟動(dòng)文件為lib子目錄下的bar.js。當(dāng)使用require('bar')命令加載該模塊時(shí)，實(shí)際上加載的是./node_modules/bar/lib/bar.js文件。下面寫法會(huì)起到同樣效果。

var bar = require('bar/lib/bar.js')

如果模塊目錄中沒有package.json文件，node.js會(huì)嘗試在模塊目錄中尋找index.js或index.node文件進(jìn)行加載。

模塊一旦被加載以后，就會(huì)被系統(tǒng)緩存。如果第二次還加載該模塊，則會(huì)返回緩存中的版本，這意味著模塊實(shí)際上只會(huì)執(zhí)行一次。如果希望模塊執(zhí)行多次，則可以讓模塊返回一個(gè)函數(shù)，然后多次調(diào)用該函數(shù)。

核心模塊

如果只是在服務(wù)器運(yùn)行JavaScript代碼，用處并不大，因?yàn)榉?wù)器腳本語(yǔ)言已經(jīng)有很多種了。Node.js的用處在于，它本身還提供了一系列功能模塊，與操作系統(tǒng)互動(dòng)。這些核心的功能模塊，不用安裝就可以使用，下面是它們的清單。

• http：提供HTTP服務(wù)器功能。
• url：解析URL。
• fs：與文件系統(tǒng)交互。
• querystring：解析URL的查詢字符串。
• child_process：新建子進(jìn)程。
• util：提供一系列實(shí)用小工具。
• path：處理文件路徑。
• crypto：提供加密和解密功能，基本上是對(duì)OpenSSL的包裝。

上面這些核心模塊，源碼都在Node的lib子目錄中。為了提高運(yùn)行速度，它們安裝時(shí)都會(huì)被編譯成二進(jìn)制文件。

核心模塊總是最優(yōu)先加載的。如果你自己寫了一個(gè)HTTP模塊，require('http')加載的還是核心模塊。

自定義模塊

Node模塊采用CommonJS規(guī)范。只要符合這個(gè)規(guī)范，就可以自定義模塊。

下面是一個(gè)最簡(jiǎn)單的模塊，假定新建一個(gè)foo.js文件，寫入以下內(nèi)容。

// foo.js

module.exports = function(x) {
    console.log(x);
};

上面代碼就是一個(gè)模塊，它通過module.exports變量，對(duì)外輸出一個(gè)方法。

這個(gè)模塊的使用方法如下。

// index.js

var m = require('./foo');

m("這是自定義模塊");

上面代碼通過require命令加載模塊文件foo.js（后綴名省略），將模塊的對(duì)外接口輸出到變量m，然后調(diào)用m。這時(shí)，在命令行下運(yùn)行index.js，屏幕上就會(huì)輸出“這是自定義模塊”。

$ node index
這是自定義模塊

module變量是整個(gè)模塊文件的頂層變量，它的exports屬性就是模塊向外輸出的接口。如果直接輸出一個(gè)函數(shù)（就像上面的foo.js），那么調(diào)用模塊就是調(diào)用一個(gè)函數(shù)。但是，模塊也可以輸出一個(gè)對(duì)象。下面對(duì)foo.js進(jìn)行改寫。

// foo.js

var out = new Object();

function p(string) {
  console.log(string);
}

out.print = p;

module.exports = out;

上面的代碼表示模塊輸出out對(duì)象，該對(duì)象有一個(gè)print屬性，指向一個(gè)函數(shù)。下面是這個(gè)模塊的使用方法。

// index.js

var m = require('./foo');

m.print("這是自定義模塊");

上面代碼表示，由于具體的方法定義在模塊的print屬性上，所以必須顯式調(diào)用print屬性。

異常處理

Node是單線程運(yùn)行環(huán)境，一旦拋出的異常沒有被捕獲，就會(huì)引起整個(gè)進(jìn)程的崩潰。所以，Node的異常處理對(duì)于保證系統(tǒng)的穩(wěn)定運(yùn)行非常重要。

一般來(lái)說(shuō)，Node有三種方法，傳播一個(gè)錯(cuò)誤。

• 使用throw語(yǔ)句拋出一個(gè)錯(cuò)誤對(duì)象，即拋出異常。
• 將錯(cuò)誤對(duì)象傳遞給回調(diào)函數(shù)，由回調(diào)函數(shù)負(fù)責(zé)發(fā)出錯(cuò)誤。
• 通過EventEmitter接口，發(fā)出一個(gè)error事件。

try...catch結(jié)構(gòu)

最常用的捕獲異常的方式，就是使用try...catch結(jié)構(gòu)。但是，這個(gè)結(jié)構(gòu)無(wú)法捕獲異步運(yùn)行的代碼拋出的異常。

try {
  process.nextTick(function () {
    throw new Error("error");
  });
} catch (err) {
  //can not catch it
  console.log(err);
}

try {
  setTimeout(function(){
    throw new Error("error");
  },1)
} catch (err) {
  //can not catch it
  console.log(err);
}

上面代碼分別用process.nextTick和setTimeout方法，在下一輪事件循環(huán)拋出兩個(gè)異常，代表異步操作拋出的錯(cuò)誤。它們都無(wú)法被catch代碼塊捕獲，因此catch代碼塊所在的那部分已經(jīng)運(yùn)行結(jié)束了。

一種解決方法是將錯(cuò)誤捕獲代碼，也放到異步執(zhí)行。

function async(cb, err) {
  setTimeout(function() {
    try {
      if (true)
        throw new Error("woops!");
      else
        cb("done");
    } catch(e) {
      err(e);
    }
  }, 2000)
}

async(function(res) {
  console.log("received:", res);
}, function(err) {
  console.log("Error: async threw an exception:", err);
});
// Error: async threw an exception: Error: woops!

上面代碼中，async函數(shù)異步拋出的錯(cuò)誤，可以同樣部署在異步的catch代碼塊捕獲。

這兩種處理方法都不太理想。一般來(lái)說(shuō)，Node只在很少場(chǎng)合才用try/catch語(yǔ)句，比如使用JSON.parse解析JSON文本。

回調(diào)函數(shù)

Node采用的方法，是將錯(cuò)誤對(duì)象作為第一個(gè)參數(shù)，傳入回調(diào)函數(shù)。這樣就避免了捕獲代碼與發(fā)生錯(cuò)誤的代碼不在同一個(gè)時(shí)間段的問題。

fs.readFile('/foo.txt', function(err, data) {
  if (err !== null) throw err;
  console.log(data);
});

上面代碼表示，讀取文件foo.txt是一個(gè)異步操作，它的回調(diào)函數(shù)有兩個(gè)參數(shù)，第一個(gè)是錯(cuò)誤對(duì)象，第二個(gè)是讀取到的文件數(shù)據(jù)。如果第一個(gè)參數(shù)不是null，就意味著發(fā)生錯(cuò)誤，后面代碼也就不再執(zhí)行了。

下面是一個(gè)完整的例子。

function async2(continuation) {
  setTimeout(function() {
    try {
      var res = 42;
      if (true)
        throw new Error("woops!");
      else
        continuation(null, res); // pass 'null' for error
    } catch(e) {
      continuation(e, null);
    }
  }, 2000);
}

async2(function(err, res) {
  if (err)
    console.log("Error: (cps) failed:", err);
  else
    console.log("(cps) received:", res);
});
// Error: (cps) failed: woops!

上面代碼中，async2函數(shù)的回調(diào)函數(shù)的第一個(gè)參數(shù)就是一個(gè)錯(cuò)誤對(duì)象，這是為了處理異步操作拋出的錯(cuò)誤。

EventEmitter接口的error事件

發(fā)生錯(cuò)誤的時(shí)候，也可以用EventEmitter接口拋出error事件。

var EventEmitter = require('events').EventEmitter;
var emitter = new EventEmitter();

emitter.emit('error', new Error('something bad happened'));

使用上面的代碼必須小心，因?yàn)槿绻麤]有對(duì)error事件部署監(jiān)聽函數(shù)，會(huì)導(dǎo)致整個(gè)應(yīng)用程序崩潰。所以，一般總是必須同時(shí)部署下面的代碼。

emitter.on('error', function(err) {
  console.error('出錯(cuò)：' + err.message);
});

uncaughtException事件

當(dāng)一個(gè)異常未被捕獲，就會(huì)觸發(fā)uncaughtException事件，可以對(duì)這個(gè)事件注冊(cè)回調(diào)函數(shù)，從而捕獲異常。

process.on('uncaughtException', function(err) {
  console.error('Error caught in uncaughtException event:', err);
});

try {
  setTimeout(function(){
    throw new Error("error");
  },1)
} catch (err) {
  //can not catch it
  console.log(err);
}

只要給uncaughtException配置了回調(diào)，Node進(jìn)程不會(huì)異常退出，但異常發(fā)生的上下文已經(jīng)丟失，無(wú)法給出異常發(fā)生的詳細(xì)信息。而且，異?？赡軐?dǎo)致Node不能正常進(jìn)行內(nèi)存回收，出現(xiàn)內(nèi)存泄露。所以，當(dāng)uncaughtException觸發(fā)后，最好記錄錯(cuò)誤日志，然后結(jié)束Node進(jìn)程。

process.on('uncaughtException', function(err) {
  logger(err);
  process.exit(1);
});

unhandledRejection事件

iojs有一個(gè)unhandledRejection事件，用來(lái)監(jiān)聽沒有捕獲的Promise對(duì)象的rejected狀態(tài)。

var promise = new Promise(function(resolve, reject) {
  reject(new Error("Broken."));
});

promise.then(function(result) {
  console.log(result);
})

上面代碼中，promise的狀態(tài)變?yōu)閞ejected，并且拋出一個(gè)錯(cuò)誤。但是，不會(huì)有任何反應(yīng)，因?yàn)闆]有設(shè)置任何處理函數(shù)。

只要監(jiān)聽unhandledRejection事件，就能解決這個(gè)問題。

process.on('unhandledRejection', function (err, p) {
  console.error(err.stack);
})

需要注意的是，unhandledRejection事件的監(jiān)聽函數(shù)有兩個(gè)參數(shù)，第一個(gè)是錯(cuò)誤對(duì)象，第二個(gè)是產(chǎn)生錯(cuò)誤的promise對(duì)象。這可以提供很多有用的信息。

var http = require('http');

http.createServer(function (req, res) {
  var promise = new Promise(function(resolve, reject) {
    reject(new Error("Broken."))
  })

  p.info = {url: req.url}
}).listen(8080)

process.on('unhandledRejection', function (err, p) {
  if (p.info && p.info.url) {
    console.log('Error in URL', p.info.url)
  }
  console.error(err.stack)
})

上面代碼會(huì)在出錯(cuò)時(shí)，輸出用戶請(qǐng)求的網(wǎng)址。

Error in URL /testurl
Error: Broken.
  at /Users/mikeal/tmp/test.js:9:14
  at Server.<anonymous> (/Users/mikeal/tmp/test.js:4:17)
  at emitTwo (events.js:87:13)
  at Server.emit (events.js:169:7)
  at HTTPParser.parserOnIncoming [as onIncoming] (_http_server.js:471:12)
  at HTTPParser.parserOnHeadersComplete (_http_common.js:88:23)
  at Socket.socketOnData (_http_server.js:322:22)
  at emitOne (events.js:77:13)
  at Socket.emit (events.js:166:7)
  at readableAddChunk (_stream_readable.js:145:16)

命令行腳本

node腳本可以作為命令行腳本使用。

$ node foo.js

上面代碼執(zhí)行了foo.js腳本文件。

foo.js文件的第一行，如果加入了解釋器的位置，就可以將其作為命令行工具直接調(diào)用。

#!/usr/bin/env node

調(diào)用前，需更改文件的執(zhí)行權(quán)限。

$ chmod u+x myscript.js
$ ./foo.js arg1 arg2 ...

作為命令行腳本時(shí)，console.log用于輸出內(nèi)容到標(biāo)準(zhǔn)輸出，process.stdin用于讀取標(biāo)準(zhǔn)輸入，child_process.exec()用于執(zhí)行一個(gè)shell命令。

參考鏈接

• Cody Lindley, Package Managers: An Introductory Guide For The Uninitiated Front-End Developer
• Stack Overflow, What is Node.js?
• Andrew Burgess, Using Node's Event Module
• James Halliday, task automation with npm run- Romain Prieto, Working on related Node.js modules locally
• Alon Salant, Export This: Interface Design Patterns for Node.js Modules
• Node.js Manual & Documentation, Modules
• Brent Ertz, Creating and publishing a node.js module
• Fred K Schott, "npm install --save" No Longer Using Tildes
• Satans17, Node穩(wěn)定性的研究心得
• Axel Rauschmayer, Write your shell scripts in JavaScript, via Node.js