Sea.js 是一個遵循 CommonJS 規範的 JavaScript 模組加載框架,提供簡潔而直接的模組化開發體驗,由阿里巴巴、騰訊等團隊共同維護。
它追求自然、直觀的程式碼組織方式,核心特性有三點:
一是簡單友好的模組定義規範:遵循 CMD 規範,寫法與 Node.js 相近,學習成本低。
二是自然的程式碼組織方式:依賴自動加載、設定簡潔,讓注意力回到業務邏輯本身。
三是生態與可擴充性:提供常用外掛,對開發除錯與效能優化都有幫助,並留有豐富的擴充介面。
exports 是一個物件,用來對外提供模組介面。
define(function (require, exports, module) {
var a = require("./init");
var fun1 = function () {
return a.write("模組 main 呼叫模組 init 的 write 方法");
};
exports.fun1 = fun1;
});
除了往 exports 加成員,也可以直接回傳物件。
define(function (require, exports, module) {
var a = require("./init");
var fun1 = function () {
return a.write("模組 main 呼叫模組 init 的 write 方法");
};
return { fun1: fun1 };
});
若模組沒有業務邏輯,只是回傳一組方法,可以最簡化:
define({
fun1: function () { alert("模組 main 的 fun1 呼叫成功"); }
});
define(function (require, exports, module) {
var a = require("./init"); // ./ 當前目錄,../ 上層目錄,/ 根目錄
var fun1 = function () {
return a.write("模組 main 呼叫模組 init 的 write 方法");
};
exports.b = function () { alert("bb") }; // 無效,見下方說明
module.exports = { fun1: fun1 };
});
這裡有個關鍵陷阱:exports 只是 module.exports 的一個引用。在函式內部對 exports 重新賦值,並不會改變 module.exports,因此那個 b 方法實際上沒有被導出。一旦你把 module.exports 整體替換掉,之前掛在 exports 上的成員也全部失效。
簽名為 require.async(id || [], callback?),用於在模組內部異步載入其他模組,載入完成後執行回呼,callback 可省略。
define(function (require, exports, module) {
require.async('./init', function (a) {
a.write("模組 main 呼叫模組 init 的 write 方法");
});
require.async(['./init', "./search"], function (a, b) {
a.write("模組 main 呼叫模組 init 的 write 方法");
b.search("search 模組成功引入");
});
});
module.id(String):模組的唯一識別碼。
module.uri(String):依路徑解析規則得到的模組絕對路徑。一般情況下(未在 define 中手動指定 id),module.id 與 module.uri 的值完全相同。
module.dependencies(Array):一個陣列,記錄當前模組的依賴。
Sea.js 屬於 CMD 規範,與 RequireJS 的 AMD 規範是同期但不同的方案。隨著瀏覽器原生支援 ES Modules、打包工具(Webpack、Rollup、Vite)成為主流,Sea.js 這類執行期模組加載器在新專案中的使用已大幅減少;不過理解 CMD 的「就近依賴、延遲執行」思路,對讀懂老專案與打包工具的 tree shaking 概念仍有幫助。