第三方外掛很強大,但不該一股腦兒全部在頁面載入時就抓下來——尤其那些只在特定操作後才用得到的。jQuery 內建了一個方法可以按需載入單一 js 檔,載入完成後在回呼中執行後續動作。
jQuery.getScript("/path/to/myscript.js", function(data, status, jqxhr) {
/* 載入完成後要做的事 */
});
這個方法會回傳一個 jqxhr 物件,因此可以改用鏈式寫法處理成功與失敗:
jQuery.getScript("/path/to/myscript.js")
.done(function() {
/* 載入成功 */
})
.fail(function() {
/* 載入失敗,執行補救 */
});
jQuery.getScript("jquery.cookie.js")
.done(function() {
jQuery.cookie("cookie_name", "value", { expires: 7 });
});
注意後續操作必須寫在 done 或回呼裡,不能寫在 getScript 之後——載入是非同步的,寫在外面時外掛可能還沒準備好,會出現「$ is not a function」這類錯誤。
這是最容易忽略的一點。jQuery 在跨域請求時會自動在網址後附加時間戳以避免快取,因此預設情況下 getScript 載入的腳本不會被快取,每次呼叫都會重新下載。
如果希望腳本被瀏覽器快取(靜態函式庫通常都該如此),有兩種做法。一是全域設定:
jQuery.ajaxSetup({ cache: true });
二是只針對這一次請求設定,這是不影響其他請求的更安全方式:
jQuery.ajax({
url: "jquery.cookie.js",
dataType: "script",
cache: true
}).done(function() {
jQuery.cookie("cookie_name", "value", { expires: 7 });
});
我建議優先採用第二種。ajaxSetup 會改變全域預設行為,可能讓同一頁其他真正需要避開快取的請求一併失效,這類「為了修一個問題而改動全域設定」的做法,往往在別處生出更難查的 bug。
如果只是要載入一個知之甚詳的腳本,用原生 Promise 就能完成,不必依賴 jQuery:
function loadScript(src) {
return new Promise(function(resolve, reject){
var s = document.createElement("script");
s.src = src;
s.onload = resolve;
s.onerror = reject;
document.head.appendChild(s);
});
}
// 使用
loadScript("/js/chart.min.js")
.then(function(){ /* 初始化圖表 */ })
.catch(function(){ /* 處理失敗 */ });
這個寫法的優點是:不依賴 jQuery、可用 async/await 串接多個腳本、錯誤處理更明確。要依序載入多個有相依關係的檔案時:
await loadScript("/js/a.js");
await loadScript("/js/b.js"); // b 相依於 a
init();
動態載入是效能最佳化的一環,但別忘了:多個小檔案各自發請求的總成本,往往高於一次載入合併後的檔案。若某個腳本幾乎所有使用者都會用到,直接放進打包流程會比動態載入更好。動態載入真正值得使用的時機是「多數使用者不會觸發」的功能,例如只在點擊「檢視報表」後才需要的圖表庫。
另外,動態載入的第三方腳本應盡量加上完整性檢查(例如比對雜湊值),因為它繞過了你在建置階段對檔案內容的掌握。