寫過 Node.js 的人大概都熟悉 exports 物件,最常見的用法如下(假設檔名為 rocker.js):
exports.name = function () {
console.log('My name is Lemmy Kilmister');
};
在另一個檔案中引用:
var rocker = require('./rocker.js');
rocker.name(); // My name is Lemmy Kilmister
關鍵在於:module.exports 才是真正的介面,exports 只是它的輔助工具。最終回傳給呼叫方的是 module.exports,而不是 exports。
exports 上收集到的所有屬性與方法,都會被賦值到 module.exports——但這有個前提:module.exports 本身尚未具備任何屬性與方法。若 module.exports 已經有自己的內容,exports 收集到的資訊就會被忽略。
把 rocker.js 改寫如下:
module.exports = 'ROCK IT!';
exports.name = function () {
console.log('My name is Lemmy Kilmister');
};
再次引用並執行:
var rocker = require('./rocker.js');
rocker.name(); // TypeError: Object ROCK IT! has no method 'name'
報錯是因為模組忽略了 exports 上的 name 方法,直接回傳字串 "ROCK IT!"。由此可見,你的模組並不一定非得是「實例化物件」——它可以是任何合法的 JavaScript 值:boolean、number、date、JSON、string、function、array 等等。若你沒有顯式設定 module.exports,模組就會是 exports 掛上去的內容。
module.exports = function (name, age) {
this.name = name;
this.age = age;
this.about = function () {
console.log(this.name + ' is ' + this.age + ' years old');
};
};
使用方式:
var Rocker = require('./rocker.js');
var r = new Rocker('Ozzy', 62);
r.about(); // Ozzy is 62 years old
module.exports = ['Lemmy Kilmister', 'Ozzy Osbourne', 'Ronnie James Dio', 'Steven Tyler', 'Mick Jagger'];
使用方式:
var rocker = require('./rocker.js');
console.log('Rockin in heaven: ' + rocker[2]); // Ronnie James Dio
若你希望模組本身就是某個特定型別(函式、陣列、字串……),請用 module.exports;若只是想輸出一般的實例化物件,用 exports 即可。
為 module.exports 添加屬性與為 exports 添加屬性的語法完全一樣:
module.exports.name = function () {
console.log('My name is Lemmy Kilmister');
};
// 等價寫法
exports.name = function () {
console.log('My name is Lemmy Kilmister');
};
但兩者結果並不相同——前者直接改動真正的介面,後者只是往輔助工具上加東西。一般建議用 exports 導出;只有當你打算把模組從「實例化物件」改成其他型別時,才動用 module.exports。牢記一個原則:一旦替 module.exports 重新賦值,就必須放棄 exports。