Node.js模組系統

標籤：

為了讓Node.js的檔案可以相互調用，Node.js提供了一個簡單的模組系統。

模組是Node.js 應用程式的基本組成部分，檔案和模組是一一對應的。換言之，一個 Node.js 檔案就是一個模組，這個檔案可能是JavaScript 代碼、JSON 或者編譯過的C/C++ 擴充。

建立模組

在 Node.js 中，建立一個模組非常簡單，如下我們建立一個 ‘main.js‘ 檔案，代碼如下:

var hello = require(‘./hello‘);hello.world();

以上執行個體中，代碼 require(‘./hello‘) 引入了目前的目錄下的hello.js檔案（./ 為目前的目錄，node.js預設尾碼為js）。

Node.js 提供了exports 和 require 兩個對象，其中 exports 是模組公開的介面，require 用於從外部擷取一個模組的介面，即所擷取模組的 exports 對象。

接下來我們就來建立hello.js檔案，代碼如下：

exports.world = function() {  console.log(‘Hello World‘);}

在以上樣本中，hello.js 通過 exports 對象把 world 作為模組的提供者，在 main.js 中通過 require(‘./hello‘) 載入這個模組，然後就可以直接訪 問 hello.js 中 exports 對象的成員函數了。

有時候我們只是想把一個對象封裝到模組中，格式如下：

module.exports = function() {  // ...}

例如:

//hello.js function Hello() { var name; this.setName = function(thyName) { name = thyName; }; this.sayHello = function() { console.log(‘Hello ‘ + name); }; }; module.exports = Hello;

這樣就可以直接獲得這個對象了：

//main.js var Hello = require(‘./hello‘); hello = new Hello(); hello.setName(‘BYVoid‘); hello.sayHello();

模組介面的唯一變化是使用 module.exports = Hello 代替了exports.world = function(){}。 在外部參考該模組時，其介面對象就是要輸出的 Hello 對象本身，而不是原先的 exports。

服務端的模組放在哪裡

也許你已經注意到，我們已經在代碼中使用了模組了。像這樣：

var http = require("http");...http.createServer(...);

Node.js中內建了一個叫做"http"的模組，我們在我們的代碼中請求它並把傳回值賦給一個本地變數。

這把我們的本地變數變成了一個擁有所有 http 模組所提供的公用方法的對象。

Node.js 的 require方法中的檔案尋找策略如下：

由於Node.js中存在4類別模組（原生模組和3種檔案模組），儘管require方法極其簡單，但是內部的載入卻是十分複雜的，其載入優先順序也各自不同。如所示：

從檔案模組緩衝中載入

儘管原生模組與檔案模組的優先順序不同，但是都不會優先於從檔案模組的緩衝中載入已經存在的模組。

從原生模組載入

原生模組的優先順序僅次於檔案模組緩衝的優先順序。require方法在解析檔案名稱之後，優先檢查模組是否在原生模組列表中。以http模組為例，儘管在目錄下存在一個http/http.js/http.node/http.json檔案，require("http")都不會從這些檔案中載入，而是從原生模組中載入。

原生模組也有一個緩衝區，同樣也是優先從緩衝區載入。如果緩衝區沒有被載入過，則調用原生模組的載入方式進行載入和執行。

從檔案載入

當檔案模組緩衝中不存在，而且不是原生模組的時候，Node.js會解析require方法傳入的參數，並從檔案系統中載入實際的檔案，載入過程中的封裝和編譯細節在前一節中已經介紹過，這裡我們將詳細描述尋找檔案模組的過程，其中，也有一些細節值得知曉。

require方法接受以下幾種參數的傳遞：

• http、fs、path等，原生模組。
• ./mod或../mod，相對路徑的檔案模組。
• /pathtomodule/mod，絕對路徑的檔案模組。
• mod，非原生模組的檔案模組。

Node.js模組系統