做專案時遇到一個很典型的跨瀏覽器問題:用 JavaScript 動態建立的 <script> 標籤,在 IE8 底下完全不觸發 onload 事件。這篇記錄整個排查過程與幾種可行的替代方案。
var loadJs = function (src, fun) {
var script = null;
script = document.createElement("script");
script.type = "text/javascript";
script.src = src;
if (typeof fun === "function") {
script.onload = fun;
}
document.getElementsByTagName("head")[0].appendChild(script);
};
loadJs("js/jquery-1.11.0.min.js", function () {
console.log("From jQuery");
});
loadJs("test.js", function () {
console.log("From test.js");
});
其中 test.js 的內容是:
console.log(typeof jQuery);
執行結果:
undefined // test.js 執行時,jQuery 還沒載入 >> typeof jQuery // 但在主控台執行卻找得到 jQuery,證明是載入順序問題 "function"
更麻煩的是,script.onload 根本沒有被執行。程式碼明明已經載入,事件卻不觸發——這是 IE8 及以下版本的已知行為:它對動態插入的 script 元素不支援 onload。
IE 的舊事件模型用 readyState 表示載入狀態,所以要把 onload 換成 onreadystatechange:
var loadJs = function (src, fun) {
var script = null;
script = document.createElement("script");
script.type = "text/javascript";
script.src = src;
if (typeof fun === "function") {
script.onreadystatechange = function () {
var r = script.readyState;
console.log(src + ": " + r);
if (r === 'loaded' || r === 'complete') {
script.onreadystatechange = null;
fun();
}
};
}
document.getElementsByTagName("head")[0].appendChild(script);
};
執行結果:
undefined js/jquery-1.11.0.min.js: loading test.js: complete From test.js js/jquery-1.11.0.min.js: loaded From jQuery
onload 的功能算是找回來了,但新問題出現:它不是按順序載入的。jQuery 還在 loading 時,test.js 已經 complete,於是 test.js 的內容先跑,才會印出 undefined。
把後續載入寫在前一個的回呼裡,形成串聯:
loadJs("js/jquery-1.11.0.min.js", function () {
console.log("From jQuery");
loadJs("test.js", function () {
console.log("From test.js");
});
});
結果:
js/jquery-1.11.0.min.js: loading js/jquery-1.11.0.min.js: loaded From jQuery function test.js: complete From test.js
順序完全正確了,但缺點也很明顯:層層嵌套,檔案一多就成了回呼地獄。
還有一種寫法能讓瀏覽器依序處理:
var loadJs = function (src, fun) {
var script = null;
script = document.createElement("script");
script.type = "text/javascript";
script.src = src;
if (typeof fun === "function") {
script.onreadystatechange = function () {
var r = script.readyState;
console.log(src + ": " + r);
if (r === 'loaded' || r === 'complete') {
script.onreadystatechange = null;
fun();
}
};
}
document.write(script.outerHTML);
// document.getElementsByTagName("head")[0].appendChild(script);
};
loadJs("js/jquery-1.11.0.min.js", function () {
console.log("From jQuery");
});
loadJs("test.js", function () {
console.log("From test.js");
});
結果:
function js/jquery-1.11.0.min.js: loaded From jQuery test.js: loaded From test.js
順序對了。若把兩個 loadJs 的呼叫順序對調,輸出順序也跟著對調,行為接近同步載入。
要老實說:document.write 在頁面載入完成之後呼叫會直接清空整個文件,風險相當高,不建議在新專案使用。而 onreadystatechange 只解決了「IE8 不觸發 onload」這一半的問題,載入順序仍得自己想辦法。
真正合理的做法是加上特性偵測,讓兩種事件並存,再搭配一個小型的佇列機制來控制順序:
script.onload = script.onreadystatechange = function () {
if (!this.readyState || this.readyState === "loaded" || this.readyState === "complete") {
script.onload = script.onreadystatechange = null;
fun();
}
};
這段寫法同時滿足標準瀏覽器與舊 IE,是當時函式庫的標準手法。不過如果專案沒有維護舊 IE 的負擔,直接用 <script defer>、ES Module 的 import,或 webpack/Vite 這類打包工具處理依賴順序,會輕鬆太多——這類問題本來就該由工具鏈承擔,而不是靠手寫的載入器硬扛。