本規(guī)范致力于描述一類可以同時適用于客戶端和服務(wù)器端的模塊系統(tǒng)。該系統(tǒng)中的模塊擁有自己的作用域，可以從其他模塊導(dǎo)入單例對象，或者對外提供 API。 Require

require 是一個函數(shù)對象。

讓客戶滿意是我們工作的目標(biāo)，不斷超越客戶的期望值來自于我們對這個行業(yè)的熱愛。我們立志把好的技術(shù)通過有效、簡單的方式提供給客戶，將通過不懈努力成為客戶在信息化領(lǐng)域值得信任、有價值的長期合作伙伴，公司提供的服務(wù)項(xiàng)目有：空間域名、雅安服務(wù)器托管、營銷軟件、網(wǎng)站建設(shè)、環(huán)縣網(wǎng)站維護(hù)、網(wǎng)站推廣。require 函數(shù)接受一個稱為模塊標(biāo)識符的參數(shù)。 require 函數(shù)返回外部模塊提供的 API。 當(dāng)發(fā)生循環(huán)依賴時，一個外部模塊被其依賴模塊導(dǎo)入時，它可能未被完全執(zhí)行。在此種情況下，當(dāng)前模塊調(diào)用 require 函數(shù)所返回的對象必須包含該外部模塊已經(jīng)準(zhǔn)備好的輸出物。 如果不能返回所請求的模塊，則 require 函數(shù)應(yīng)該拋出異常。 require 函數(shù)可以有一個 main 屬性。 當(dāng)屬性 main 存在，它應(yīng)該是只讀的且不能刪除。 main 屬性應(yīng)該是 undefined，或是已加載模塊的 module 對象。 require 函數(shù)可以有一個 paths 屬性，該屬性是一個具有優(yōu)先秩序的路徑數(shù)組，優(yōu)先級從高到低，路徑一直回溯到頂級模塊目錄。 paths 屬性不應(yīng)存在于沙盒中。 所有模塊中的 paths 屬性應(yīng)該一致。 使用另一個對象替換 paths 對象是無效的。 如果 paths 屬性存在，修改 paths 內(nèi)容會對模塊搜索行為產(chǎn)生影響。 如果 paths 屬性存在，它所包含的路徑可能不是全部的搜索路徑。因?yàn)榧虞d器可以能會在搜索 paths 提供的路徑之前或之后去檢查其它的路徑。 如果 paths 屬性存在，加載器責(zé)任去解析、標(biāo)準(zhǔn)化、規(guī)范化路徑。 模塊上下文 一個模塊中只有一個自由變量 require，該變量符合以上對 require 函數(shù)的定義。 一個模塊中只有一個自由變量 exports，當(dāng)模塊被執(zhí)行時，該模塊對外提供的 API 被添加到該 exports 對象上。 模塊必須使用 exports 對象作為唯一的輸出手段。 一個模塊中應(yīng)該包含一個自由變量 module，該變量是一個 Object 對象。 module 對象應(yīng)該擁有一個 id 屬性，它是模塊的頂級屬性。當(dāng)執(zhí)行 require(module.id) 時，返回 module.id 所屬模塊的輸出對象。如果該屬性被實(shí)現(xiàn)，則它應(yīng)該是一個只讀屬性，不能刪除。 module 對象可以有一個 uri 屬性，該屬性指向模塊源文件。uri 屬性不應(yīng)存在于沙盒中。 模塊標(biāo)識符 模塊標(biāo)識符是一個由多個詞匯組成的字符串，不同詞匯之間使用正斜杠分隔。 單個詞匯應(yīng)該是駝峰標(biāo)識符，. 或 ..。 模塊標(biāo)識符不能包含文件后綴名，例如 .js。 模塊標(biāo)識符可以是相對的，也可以是頂級的。如果標(biāo)識符首個單詞是 . 或 ..，那么該標(biāo)識符就是相對的。 頂級標(biāo)識符是相對于所謂根命名空間而言。 相對標(biāo)識符是相對于 require 函數(shù)所處的模塊而言。 未說明

本規(guī)范有以下重要點(diǎn)未說明：

模塊是否存儲于數(shù)據(jù)庫、文件系統(tǒng)或工廠函數(shù)中，又或者可以和鏈接庫進(jìn)行互換。 模塊加載器是否支持使用 PATH 環(huán)境變量來解析模塊標(biāo)識符。

PS：本規(guī)范從 CommonJS 官方英文版本轉(zhuǎn)譯而來，斜體部分表示譯文存在商榷。

Ref:

CommonJS Module 1.1.1

本文題目：CommonJS模塊規(guī)范1.1.1-創(chuàng)新互聯(lián)
新聞來源：http://weahome.cn/article/cssphd.html