DIV CSS 佈局教程網

如何動態載入外部 JavaScript 檔案:JsLoader 設計與跨瀏器 Callback
編輯:關於JavaScript     

有時候某些腳本只在特定頁面才需要,一次全部用 <script> 標籤載入顯得笨重。動態載入的關鍵是:用 JS 建立一個 script 元素掛進 DOM,然後想辦法知道它「什麼時候載入完成」。

一、JsLoader.js

var MiniSite = new Object();

/**
 * 判斷瀏覽器類型
 */
MiniSite.Browser = {
    ie: /msie/.test(window.navigator.userAgent.toLowerCase()),
    moz: /gecko/.test(window.navigator.userAgent.toLowerCase()),
    opera: /opera/.test(window.navigator.userAgent.toLowerCase()),
    safari: /safari/.test(window.navigator.userAgent.toLowerCase())
};

/**
 * JsLoader:載入外部 js 檔案
 */
MiniSite.JsLoader = {
    /**
     * @param sUrl      要載入的 js 位址
     * @param fCallback 載入完成後的處理函式
     */
    load: function (sUrl, fCallback) {
        var _script = document.createElement('script');
        _script.setAttribute('charset', 'gbk');
        _script.setAttribute('type', 'text/javascript');
        _script.setAttribute('src', sUrl);
        document.getElementsByTagName('head')[0].appendChild(_script);

        if (MiniSite.Browser.ie) {
            // 舊版 IE 沒有 onload,用 onreadystatechange 判斷
            _script.onreadystatechange = function () {
                if (this.readyState == 'loaded' || this.readyState == 'complete') {
                    if (fCallback != undefined) { fCallback(); }
                }
            };
        } else if (MiniSite.Browser.moz) {
            _script.onload = function () {
                if (fCallback != undefined) { fCallback(); }
            };
        } else {
            // 其他瀏覽器直接執行
            if (fCallback != undefined) { fCallback(); }
        }
    }
};

二、三個實作細節

1、掛進 head 才會開始下載。建立 script 元素只是造出一個物件,必須 appendChild 到文件裡,瀏覽器才會真的發請求。

2、IE 用 onreadystatechange。舊版 IE 的 script 元素不支援 onload,只能監聽 readyState 變成 loaded 或 complete。注意判斷式裡有個常見的錯字陷阱:loaded 和 complete 你都得判斷,只判一個在某些情況下不會觸發。

3、charset 要對得上。範例寫死 gbk,是因為被載入的 jQuery 舊版本是 GBK 編碼。這裡應該改成依實際檔案編碼設定,或統一用 UTF-8,否則中文註解會變亂碼。

三、測試頁面

<!DOCTYPE HTML>
<html>
<head>
<!-- 引入 js 載入器 -->
<script type="text/javascript" src="js/JsLoader.js"></script>
<title>JsLoaderTest.html</title>
<script type="text/javascript">
if (MiniSite.Browser.ie) {
    MiniSite.JsLoader.load("js/jquery-1.9.1.js", function () {
        alert("動態載入的是 jquery-1.9.1.js");
        $(function () {
            alert("載入完成後接著做的處理");
        });
    });
} else {
    MiniSite.JsLoader.load("js/jquery-2.0.3.js", function () {
        alert("動態載入的是 jquery-2.0.3.js");
        $(function () {
            alert("載入完成後接著做的處理");
        });
    });
}
</script>
</head>
<body></body>
</html>

四、測試結果

IE 瀏器:

Chrome:

五、現代寫法

上面這套判斷瀏覽器的邏輯在今天已經不需要了 —— 所有支援 Promise 的瀏覽器都支援 onload,動態載入可以簡化成這樣:

function loadScript(src) {
    return new Promise(function (resolve, reject) {
        var s = document.createElement('script');
        s.src = src;
        s.async = true;
        s.onload = function () { resolve(s); };
        s.onerror = function () { reject(new Error('載入失敗:' + src)); };
        document.head.appendChild(s);
    });
}

// 使用:可用 async/await 串成序列,確保依賴順序
async function init() {
    await loadScript('js/jquery.min.js');
    await loadScript('js/app.js');
    console.log('全部就緒');
}

用 Promise 有兩個好處:一是能串接多個載入任務並保證順序,二是載入失敗會走 onerror 而不是靜默失敗。

六、幾點實務提醒

非同步是常態。動態插入的 script 預設 async=true,多個檔案之間不保證執行順序。若 B 依賴 A,必須像上面那樣串成序列,或改用 Promise.all 搭配檔內的依賴檢查。

重複載入會重新執行。同一個 URL 載入兩次,腳本會執行兩次。實作時建議用一個 map 記錄已載入的 src,命中就直接回傳既有 Promise。

今天有更好的選擇。如果是自己的專案,直接用 ES Module 的 import(動態寫法 import('./app.js') 本身就回傳 Promise),或交給 webpack / Vite 這類打包工具處理程式碼分割與按需載入。自己寫載入器主要還是用在往舊頁面裡注入第三方腳本這種場景。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved