頁面需要同時載入腳本、JSON 資料與一個樣板片段,三者互不依賴,但後續的初始化必須等它們都到齊才能跑。若用傳統寫法,就得自己維護一個「完成計數器」,程式立刻變亂。
還好 jQuery 提供了 $.when():它可以併發多個請求,只執行一次回呼。
$.when(
$.getScript('/media/js/wiki-min.js?build=21eb633'),
$.getJSON('https://developer.mozilla.org/en-US/demos/feeds/json/featured/')
).then(function(a, b) { // 也可以用 .done()
// 資源都載入完成,可以在這裡執行依賴它們的初始化
});
每個請求完成後,會對應傳入一組參數,格式為 [response, state, jqxhr]:
// 格式:[response, state, jqxhr], [response, state, jqxhr]
["(function(c){var e=c(\".from-search-navigate\");...", "success", Object]
[Array[15], "success", Object]
也就是說,第一個參數是腳本內容的字串,第二個是回傳的 JSON(這裡是一個長度 15 的陣列),第三個則是 jqXHR 物件。
$.when(
$.getScript('/media/js/wiki-min.js?build=21eb633'),
$.getJSON('https://developer.mozilla.org/en-US/demos/feeds/json/featured/'),
$.get('/')
).then(function(a, b, c) {
console.log(a, b, c);
});
.then() 的成功回呼只在所有請求都成功時才執行。若其中任何一個失敗,就會跳到失敗分支。寫法如下:
$.when(
$.getScript('/a.js'),
$.getJSON('/data.json')
)
.done(function(scriptRes, jsonRes){
// 全部成功
})
.fail(function(){
// 任一失敗都會進來
});
如果需要「無論成功失敗都要執行」的收尾(例如關掉 loading 動畫),加上 .always():
.always(function(){
$('#loading').hide();
});
$.when() 是「全部完成才繼續」。若需求是「哪個先回來就用哪個」,那是 Deferred 的另一種用法,需要自己組合,或用 Promise.race()(原生 Promise)來表達。
$.when() 背後是 jQuery 的 Deferred 物件,它把「非同步的結果」變成可以組合、可以串接、可以傳遞的物件。這正是後來 Promises/A+ 規範與原生 Promise 的核心概念。學會 Deferred,等於提前理解了現代非同步程式設計。
在今天的專案裡,如果沒有重度依賴 jQuery,直接用原生寫法會更合適:
Promise.all([
fetch('/data.json').then(r => r.json()),
fetch('/tpl.html').then(r => r.text())
]).then(([data, tpl]) => {
// 兩個都完成
}).catch(err => {
console.error(err);
});
動態載入腳本若改用 ES Module 的 import(),也能回傳 Promise,同樣可以放進 Promise.all() 裡一起等待。