在「按需載入」的情境中,我們常需要在腳本載入完成後執行一段回呼函數。問題是:要怎麼知道它真的載入完了?
主流做法是對動態建立的 script 元素掛上 onload。Firefox 2、Firefox 3、Safari 3.1+、Opera 9.6+ 都能正確支援,但 IE6 與 IE7 完全不理會這個事件。
IE 得走另一條路:用 onreadystatechange 追蹤每個狀態變化。狀態值包含 loading、loaded、interactive、complete,當 readyState 變成 loaded 或 complete 時,即代表載入完成,可以觸發回呼。
關於 readyState 有兩點補充:在 interactive 狀態下,使用者已經可以與頁面互動;另外 Opera 其實也支援 onreadystatechange,但它的狀態值語意與 IE 有明顯差異,不能照搬同樣的判斷邏輯。
<script type="text/javascript">
function include_JS(file) {
var _doc = document.getElementsByTagName('head')[0];
var js = document.createElement('script');
js.setAttribute('type', 'text/javascript');
js.setAttribute('src', file);
_doc.appendChild(js);
if (!/*@cc_on!@*/0) {
// 非 IE:Firefox2/3、Safari3.1+、Opera9.6+ 支援 onload
js.onload = function () {
alert('載入完成(onload)');
};
} else {
// IE6、IE7:使用 onreadystatechange
js.onreadystatechange = function () {
if (js.readyState == 'loaded' || js.readyState == 'complete') {
alert('載入完成(onreadystatechange)');
}
};
}
return false;
}
// 使用方式
include_JS('https://www.planabc.net/wp-includes/js/jquery/jquery.js');
</script>
那段 /*@cc_on!@*/0 是 IE 條件編譯註解的技巧:在 IE 中它會被求值為 0(falsy),其他瀏覽器則視為註解而回傳 0 的相反值,藉此辨別環境。技巧聰明,但可讀性差,現代的作法直接用 document.documentMode 或功能偵測即可。
還有兩個容易忽略的細節。第一,IE 下 onreadystatechange 有可能觸發多次,因此回呼函數最好加一個已完成旗標,避免重複執行。第二,加上 onload 之後仍應處理 onerror:腳本路徑寫錯或網路中斷時,若沒有錯誤處理,回呼永遠不會被呼叫,而程式往往會靜默失敗,留下難以追查的問題。
最後要說的是,今天幾乎不必再手寫這套邏輯了。動態 import()、Promise 包裝的 script 載入器,或任何成熟的模組打包工具,都已把載入時序處理妥当。理解這些歷史包袱的價值,在於你會明白為什麼現代工具要設計成那樣。