本頁使用了標題或全文手工轉換

CommonJS

維基百科,自由的百科全書
跳至導覽 跳至搜尋

CommonJS是一個專案,其目標是為JavaScript網頁瀏覽器之外建立模組約定。建立這個專案的主要原因是當時缺乏普遍可接受形式的JavaScript指令碼模組單元,模組在與執行JavaScript指令碼的常規網頁瀏覽器所提供的不同的環境下可以重複使用。

歷史[編輯]

這個專案由Mozilla工程師Kevin Dangoor於2009年1月發起,最初名為ServerJS[1]。在2009年8月,這個專案被改名為「CommonJS」來展示其API的廣泛的應用性[2]。有關規定在一個開放行程中被建立和認可,一個規定只有在已經被多個實現完成之後才被認為是最終的[3]。 CommonJS不隸屬於致力於ECMAScriptEcma國際的工作群組 TC39,但是TC39的一些成員參與了這個專案[4]

在2013年5月,Node.js包管理器npm的作者Isaac Z. Schlueter,宣佈Node.js已經廢棄了CommonJS,Node.js核心開發者應避免使用它[5]

規定[編輯]

規定列表包括[6]

目前[編輯]

  • Modules/1.0 (被Modules/1.1取代)
  • Modules/1.1
  • Modules/1.1.1
  • Packages/1.0
  • Promises/B
  • Promises/C
  • System/1.0

提議[編輯]

  • Binary/B
  • Binary/F
  • Console
  • Encodings/A
  • Filesystem/A
  • Filesystem/A/0
  • Modules/Async/A
  • Modules/Transport/B
  • Packages/1.1
  • Packages/Mappings
  • Unit Testing/1.0

模組[編輯]

require是一個函數,require函數接受一個模組識別碼,require返回外部模組的匯出的API。如果要求的模組不能被返回則require必須throw一個錯誤。在模組內,有一個自由變數require,它滿足上述定義。在模組內,有一個自由變數叫做exports,它是一個物件,模組在執行時可以向其增加模組的API。模組必須使用exports物件作為唯一的匯出方式。[7]

在模組中,必須有一個自由變數module,它是一個物件。module物件必須有一個id屬性,它是這個模組的頂層id。id屬性必須是這樣的,require(module.id)會從源出module.id的那個模組返回exports物件。(就是說module.id可以被傳遞到另一個模組,而且在要求它時必須返回最初的模組)。[8]

樣例代碼[編輯]

math.js
exports.add = function() {
    var sum = 0, i = 0, args = arguments, l = args.length;
    while (i < l) {
        sum += args[i++];
    }
    return sum;
};
increment.js
var add = require('math').add;
exports.increment = function(val) {
    return add(val, 1);
};
program.js
var inc = require('increment').increment;
var a = 1;
inc(a); // 2

module.id == "program";

實現[編輯]

參見[編輯]

參照[編輯]

外部連結[編輯]