當 JavaScript 檔案從一個變成十個,最大的問題不是語法而是「東西放哪裡」。這份程式碼示範一種用物件字面值做命名空間、並依 URL 自動分派初始化的組織方式。
$(function () {
pageJs.urls = [
'/', 'Index',
];
pageJs.run();
});
這裡的 urls 是一個「路徑 → 初始化物件」的對照表,採兩兩配對的扁平陣列存放。DOM Ready 之後呼叫 run(),由它依當前路徑決定要執行哪個物件的 init()。
第一層:Common(跨頁共用)
// 包含 HTML 元素操作。Ajax 函式也可以放在這裡
var Common = {
init: function () {
alert('Common');
}
};
第二層:Index(頁面專屬)
// url —— pages
var Index = {
init: function () {
Common.init();
this.test();
this.test2();
alert(location.pathname);
},
test: function () {
alert('test');
}
};
Index.test2 = function () {
Index.test();
alert('test2');
};
注意這裡示範了兩種定義方法的寫法:物件字面值內部的 test,以及外部掛上去的 test2。兩者等效,但用 this.test() 呼叫時要小心 this 的指向——若把 init 拆出來單獨傳遞,this 就會丟失,實務上建議統一寫成 Index.test() 這種明確形式。
第三層:Utils(純工具,不碰 DOM)
// 應移到其他 js 檔,並在本檔之前載入
// 不含任何 HTML 元素操作
var Utils = {
debug: function () { }
};
var pageJs = {
urls: [],
run: function () {
var urls = this.urls;
alert(urls.length);
if ((urls.length % 2) != 0) {
throw "urls error"; // 兩兩配對,長度必須是偶數
}
var len = urls.length / 2;
for (var i = 0; i <= len; i = i + 2) {
var pattern = new RegExp(urls[i], 'i');
if (pattern.test(location.pathname)) {
eval(urls[i + 1] + ".init()");
break;
}
}
}
};
它先用正則比對 location.pathname,命中之後就呼叫對應物件的 init。長度必須是偶數的檢查是個不錯的防呆設計,能及早攔下設定表的筆誤。
eval 的使用是這份程式碼最大的問題。eval(urls[i + 1] + ".init()") 完全可以改成 window[urls[i + 1]].init(),效果相同但沒有 eval 的效能與安全風險,也能被編輯器靜態分析到。這裡用 eval 顯然只是為了示範,實務上請務必替換。
正則比對路徑也值得商榷:'/' 作為正則會匹配到任何含斜線的路徑,也就是永遠命中第一筆。正確做法要加上錨點 ^/,或改用 location.pathname === urls[i] 精確比對。
迴圈邊界也有小瑕疵:i <= len 配合 i += 2 會多跑一次,應寫成 i < urls.length。
這套「依路徑載入對應初始化程式」的想法,今天由前端路由函式庫(React Router、Vue Router)以更成熟的方式實作,並額外提供了巢狀路由、路由參數、懶加載與瀏覽器 history 整合。而命名空間的部分,則由 ES Module 的 import / export 完全取代——每個檔案就是一個模組,依賴關係由編譯器靜態分析,不必再靠全域變數與載入順序來維持。