同時發起多個非同步任務(如多個 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"));
/**
* 等待所有 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("全部完成");
});
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("全部完成");
});
| 模式 | jQuery | 原生 | 行為 |
|---|---|---|---|
| 快速失敗 | $.when(p1, p2) | Promise.all([p1, p2]) | 任一 reject 即觸發 fail/catch |
| 全部完成 | 自訂計數器 / whenAllSettled | Promise.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`。統一完成回調適用於「需收集所有結果再決定下一步」的場景(表單驗證、批次匯入、儀表板並行載入)。