早年在一些大型網站的腳本裡看過類似 xxx.namespace("xxx.lang.array") 的寫法,當時對 JS 的理解還很粗淺,看到這種層層遞進的呼叫方式直接被震住。這次決定自己動手拆一遍,以後再遇到就不會摸不著頭緒了。
以下是一份經過壓縮、變數被改成 a、b、c、d 的實作,註解是我加的:
// 呼叫方式:bradio.namespace("bradio.lang.array");
bradio.namespace = function () { // 建立命名空間
var a = arguments, // ["bradio.lang.array"]
b = null, // 用來存放上一層物件
c, d, e, f; // c 外層計數器、d 內層計數器
// e 拆分後的陣列、f 參數個數
c = 0;
for (f = a.length; c < f; c++) {
e = ("" + a[c]).split("."); // 拆成 ["bradio", "lang", "array"]
b = bradio; // 以 bradio 作為基礎物件
// 若第一段就是 bradio,從第二段開始遍歷
for (d = "bradio" == e[0] ? 1 : 0; d < e.length; d++)
b[e[d]] = b[e[d]] || {}, b = b[e[d]]
// 等價於以下兩行:
// b[e[d]] = b[e[d]] || {} // 已存在就沿用,不存在就給個空物件
// b = b[e[d]] // 用子物件取代 b,下輪繼續往下鑽
}
return b // 回傳最末層物件
};
// bradio.namespace("bradio.lang.array");
bradio.namespace = function () {
var args = arguments,
parent = null,
arr, i, j, len;
for (i = 0, len = args.length; i < len; i++) {
// 把 "bradio.lang.array" 切成 ["bradio", "lang", "array"]
arr = ("" + args[i]).split(".");
// 每一段命名空間都從根物件 bradio 重新開始走
parent = bradio;
// 如果第一段就叫 bradio,那它已經存在,從第二段開始建即可
for (j = "bradio" == arr[0] ? 1 : 0; j < arr.length; j++) {
// 這一層沒有就補一個空物件,有就沿用
parent[arr[j]] = parent[arr[j]] || {};
// 往下一層走
parent = parent[arr[j]];
}
}
return parent;
};
關鍵只有兩行:parent[arr[j]] = parent[arr[j]] || {} 和 parent = parent[arr[j]]。前者是「不存在就補、存在就沿用」的懶初始化,後者是把游標往下一層推。迴圈走完,bradio.lang.array 這條路徑上該有的物件就都層層建好了,而且不會覆蓋掉既有的內容——這是命名空間函數最重要的性質,否則第二次呼叫就會把第一次掛上去的方法全部清空。
而外層的 for 迴圈讓它能一次接收多個參數,bradio.namespace("a.b", "c.d") 這樣一次建兩條路徑。"" + args[i] 這個看似多餘的字串串接,作用是把傳入的 String 物件或其他型別統一轉成原始字串,確保 split 一定存在。
JavaScript 沒有 Java 那種 package 機制,所有在頂層用 var 或 function 宣告的東西都掛在全域物件上,彼此可見。頁面一旦引入幾個第三方程式庫,命名衝突幾乎無可避免——你的 init() 很可能就被別人的 init() 蓋掉了。用物件一層層包住,等於自己動手做出一套假的模組系統,這在 ES Module 普及之前是標準做法。
今天的專案已經有 import / export、打包工具與 npm 可以使用,不太需要再手寫 namespace。但理解這段程式碼仍有價值:它示範了 JS 物件作為雜湊表的靈活性,也解釋了為什麼你會在舊程式碼裡看到 window.APP = window.APP || {} 這類寫法。
以上純屬個人理解,若有解讀不到位之處,歡迎指正。