DIV CSS 佈局教程網

用 jQuery.when() 讓多個 AJAX 請求共用一個回呼
編輯:JQuery特效代碼     

頁面需要同時載入腳本、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() 裡一起等待。

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