做「按需加載」時,我們需要知道腳本什麼時候下載並執行完畢,然後才能執行依賴它的回調。這件事在早年需要為不同瀏覽器寫兩套邏輯,如今已經有了統一答案。
<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 可能的取值依次是:
loading——正在下載loaded——下載完成(IE 特有語義)interactive——已解析,用戶可以參與互動complete——全部完成需要特別注意兩點。其一,在 interactive 狀態下用戶已經可以互動,此時腳本可能仍在執行。其二,Opera 雖然也支持 onreadystatechange,但它的狀態取值含義與 IE 有很大差別,直接照搬判斷會出錯——這也是為什麼當年要靠註釋 hack 把 Opera 排除在 IE 分支之外。
還有兩個實務細節:一是必須在 appendChild 之前綁定事件,否則腳本從緩存加載時可能瞬間完成,事件還沒綁上就錯過了;二是 IE 下如果同一個 URL 被加載兩次,第二次可能不重複執行腳本,需要時得加隨機查詢參數破壞緩存。
今天只需要 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。