大型專案常需要按需載入 JS 檔。這裡記錄一個以 script 標籤實作的載入器,重點在「順序」:檔案必須照指定的次序執行,特別是當後者依賴前者時。
動態插入 script 標籤時,瀏覽器會並行下載,執行時機並不保證與插入順序一致。也就是說,即使你把 A、B 依序插入,B 也可能先跑完。若 B 依賴 A 定義的函式或變數,就會拿到 undefined。
值得補充的是,JavaScript 本身允許函式與變數重複宣告(後者會覆蓋前者),因此「載入順序影響最終結果」這件事在動態載入時特別容易被忽略,直到出問題才發現。
<script language="javascript">
window.addEvent('domready', function () {
// 載入器宣告:new JsLoader(完成後的回呼, 其他參數)
new JsLoader(function () {
// 全部載入完畢後的回呼定義
}, null).include([
// 待載入檔案清單(陣列),會依序執行
]);
// 也可保留該物件,稍後重新指定 callback 並載入新檔案
});
</script>
這個版本基於 Mootools 框架,在 IE、Firefox、Chrome 上都能運作。若不打算依賴框架,自己寫的順序載入器其實不難,核心是三件事:
第一,把檔案清單複製成一個佇列,每次只處理第一個。
第二,建立 script 元素、設定 src 後插入 head,並掛上 onload(以及需要相容舊 IE 時的 onreadystatechange)作為「這一支完成了」的通知;在通知裡才去載入下一支,如此一來順序就被強制串行化了。
第三,掛上 onerror 做失敗處理,並記得逾時或異常時也要往下一個推進,否則一支 404 就會讓整條佇列卡死。
另外别忘了清理:script 元素在執行完後可以從 DOM 移除,避免 head 累積越來越多節點。
如果你只是要載入幾個固定檔案,直接用 HTML 的 script 標籤加上 defer 或改用 ES Module 的 import 會更省事,瀏覽器已經幫你處理好依賴與順序。動態載入器真正的用武之地是「檔案清單在執行期才決定」的情境,例如外掛機制、按需載入的功能模組,或是依使用者操作才抓取的第三方腳本。