萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 批次 Deferred 處理:$.when() 替代實作與多非同步任務統一完成回調

需求場景

同時發起多個非同步任務(如多個 API 請求),**全部完成**(無論成敗)後執行統一回調。jQuery `$.when()` 若任一失敗即進入 `fail()`,無法直接實作「全部完成再通知」。

原文實作分析(計數器模式)


function test(i) {
  const dfd = $.Deferred();
  if (i % 2 === 0) {
    console.log("resolve " + i);
    dfd.resolve();
  } else {
    console.log("failure " + i);
    dfd.reject();
  }
  return dfd.promise();
}

function call() {
  const dfd = $.Deferred();
  let remain = 10;

  for (let i = 0; i < 10; i++) {
    test(i)
      .done(() => { if (!--remain) dfd.resolve(); })
      .fail(() => { if (!--remain) dfd.resolve(); }); // 失敗也算完成
  }
  return dfd.promise();
}

call().done(() => console.log("all finished"));

核心邏輯:計數器 + 統一 resolve

  • 建立一個主 Deferred (`dfd`)
  • 計數器 `remain` 初始為任務總數
  • 每個子任務 `done`/`fail` 都 `remain--`
  • 當 `remain === 0` 時 `dfd.resolve()`

通用化工具函式:whenAllSettled


/**
 * 等待所有 Promise/Deferred 完成(不論成敗)
 * @param {...(Promise|Deferred)} tasks
 * @returns {Promise} 解析為陣列 [{status:'fulfilled', value}, {status:'rejected', reason}, ...]
 */
function whenAllSettled(...tasks) {
  const promises = tasks.map(t => 
    $.when(t).then(
      v => ({ status: "fulfilled", value: v }),
      r => ({ status: "rejected", reason: r })
    )
  );
  return $.when.apply($, promises); // 等待所有包裝後的 Promise
}

// 使用
whenAllSettled(
  $.ajax("/api/1"),
  $.ajax("/api/2"),
  Promise.resolve("非 jQuery Promise 也可")
).done((...results) => {
  results.forEach((r, i) => {
    if (r.status === "fulfilled") console.log(`任務 ${i} 成功:`, r.value);
    else console.error(`任務 ${i} 失敗:`, r.reason);
  });
  console.log("全部完成");
});

現代原生對應:Promise.allSettled (ES2020)


const promises = [
  fetch("/api/1").then(r => r.json()),
  fetch("/api/2").then(r => r.json()),
  Promise.reject(new Error("故意失敗"))
];

Promise.allSettled(promises).then(results => {
  results.forEach((r, i) => {
    if (r.status === "fulfilled") console.log(i, r.value);
    else console.error(i, r.reason);
  });
  console.log("全部完成");
});

進階:失敗快速模式 vs 全部完成模式

模式jQuery原生行為
快速失敗$.when(p1, p2)Promise.all([p1, p2])任一 reject 即觸發 fail/catch
全部完成自訂計數器 / whenAllSettledPromise.allSettled([p1, p2])等待所有 settled 再統一處理

實戰:表單多欄位非同步驗證


function validateField(name, value) {
  return $.ajax("/api/validate", { data: { [name]: value } })
    .then(() => ({ field: name, valid: true }))
    .catch(() => ({ field: name, valid: false, error: "驗證失敗" }));
}

const fields = { email: "test@test.com", username: "user1", phone: "0912345678" };
const tasks = Object.entries(fields).map(([k, v]) => validateField(k, v));

whenAllSettled(...tasks).done((...results) => {
  const errors = results.filter(r => r.status === "fulfilled" && !r.value.valid);
  if (errors.length) {
    showErrors(errors.map(e => e.value.error));
  } else {
    submitForm();
  }
});

總結

批次 Deferred 處理核心是**計數器模式**或**包裝為 allSettled 語意**。jQuery 無內建 `allSettled`,需自行實作;現代專案直接用 `Promise.allSettled`。統一完成回調適用於「需收集所有結果再決定下一步」的場景(表單驗證、批次匯入、儀表板並行載入)。

copyright © 萬盛學電腦網 all rights reserved