DIV CSS 佈局教程網

如何判斷動態加載的 JS 腳本已經就緒
編輯:JavaScript綜合知識     

做「按需加載」時,我們需要知道腳本什麼時候下載並執行完畢,然後才能執行依賴它的回調。這件事在早年需要為不同瀏覽器寫兩套邏輯,如今已經有了統一答案。

傳統的兼容寫法

<script>
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、Firefox3、Safari3.1+、Opera9.6+ 支持 js.onload
        js.onload = function () {
            alert('Firefox2、Firefox3、Safari3.1+、Opera9.6+ support js.onload');
        };
    } else {
        // IE6、IE7 支持 js.onreadystatechange
        js.onreadystatechange = function () {
            if (js.readyState == 'loaded' || js.readyState == 'complete') {
                alert('IE6、IE7 support js.onreadystatechange');
            }
        };
    }

    return false;
}

include_js('https://www.example.com/js/jquery/jquery.js');
</script>

核心邏輯是:onload 在 Firefox、Safari、Opera 上工作良好,但 IE6 和 IE7 不支持。IE 這邊改用 onreadystatechange 跟蹤狀態變化,當 readyState 變為 loaded 或 complete 時視為加載完成。

代碼裡那句 !/*@cc_on!@*/0 是 IE 條件編譯註釋的技巧:非 IE 瀏覽器會把整段當作註釋忽略,表達式化為 !0 即 true;IE 則會執行裡面的 @cc_on 邏輯。這是一種基於環境而非特性檢測的判斷方式,如今已被視為反面教材。

readyState 的幾個狀態

readyState 可能的取值依次是:

  • loading——正在下載
  • loaded——下載完成(IE 特有語義)
  • interactive——已解析,用戶可以參與互動
  • complete——全部完成

需要特別注意兩點。其一,在 interactive 狀態下用戶已經可以互動,此時腳本可能仍在執行。其二,Opera 雖然也支持 onreadystatechange,但它的狀態取值含義與 IE 有很大差別,直接照搬判斷會出錯——這也是為什麼當年要靠註釋 hack 把 Opera 排除在 IE 分支之外。

還有兩個實務細節:一是必須在 appendChild 之前綁定事件,否則腳本從緩存加載時可能瞬間完成,事件還沒綁上就錯過了;二是 IE 下如果同一個 URL 被加載兩次,第二次可能不重複執行腳本,需要時得加隨機查詢參數破壞緩存。

現代寫法:Promise 封裝

今天只需要 onload 和 onerror,所有瀏覽器都支持。封裝成 Promise 更好用:

function loadScript(src) {
    return new Promise(function (resolve, reject) {
        var script = document.createElement('script');
        script.src = src;
        script.async = true;

        script.onload = function () { resolve(script); };
        script.onerror = function () {
            reject(new Error('加載失敗:' + src));
        };

        document.head.appendChild(script);
    });
}

// 使用
loadScript('/js/plugin.js')
    .then(function () {
        console.log('腳本已就緒,可以調用了');
    })
    .catch(function (err) {
        console.error(err);
    });

// async/await 寫法
async function init() {
    try {
        await loadScript('/js/plugin.js');
        await loadScript('/js/another.js');
        doSomething();
    } catch (e) {
        console.error(e);
    }
}

更根本的方案

手工動態插入 script 標簽是/scripts 加載的最原始形態。今天有更好的選擇:

原生 ES Modules——用 import() 動態導入,瀏覽器自動處理依賴和加載時序:

import('/js/module.js')
    .then(function (mod) { mod.default(); })
    .catch(console.error);

打包工具的代碼分割——Webpack 的 import()、Vite 的動態導入,會自動把目標模塊及其依賴打成獨立 chunk,加載完成後再執行,並自帶錯誤重試和預加載策略。

這兩種方案相比手工插入 script,最大的優勢是依賴關係由工具解析,不必自己保證加載順序。手工方案裡如果你加載的腳本本身還依賴別的腳本,就得出現回調嵌套或者自己維護一個依賴隊列,很快會變得難以維護。

如果是要在瀏覽器裡引入第三方統計、客服這類獨立腳本,上面的 Promise 封裝已經足夠好用;如果是在項目內部做模塊拆分,請直接用打包工具或原生 ES Modules。

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