Deferred 是 jQuery 實作的 **Promise 模式**,代表「未來會完成的工作」。它解決回調地獄,提供統一的非同步流程控制介面。
三種狀態:
// 舊寫法
$.ajax({ url: "test.html", success: fn1, error: fn2 });
// 新寫法:回傳 Promise (Deferred)
$.ajax("test.html")
.done(() => alert("成功"))
.fail(() => alert("失敗"))
.always(() => alert("完成"));
$.ajax("test.html")
.done(() => console.log("第一個 done"))
.done(() => console.log("第二個 done")); // 依序執行
// 等待所有成功
$.when(
$.ajax("api/users"),
$.ajax("api/posts"),
$.ajax("api/comments")
).done((usersResp, postsResp, commentsResp) => {
// 每個回傳值為 [data, textStatus, jqXHR]
const [users] = usersResp;
const [posts] = postsResp;
render(users, posts);
}).fail(() => {
// 任一失敗即進入
alert("部分資料載入失敗");
});
// 耗時同步/非同步操作
function wait(ms) {
const dtd = $.Deferred(); // 建立 Deferred
setTimeout(() => {
console.log("執行完畢");
dtd.resolve("結果資料"); // 標記成功,傳遞資料
}, ms);
return dtd.promise(); // 只暴露 Promise 介面(不可手動 resolve/reject)
}
// 使用
$.when(wait(5000))
.done((data) => console.log("收到:", data))
.fail(() => console.log("失敗"));
const dtd = $.Deferred();
const task = function (dtd) {
setTimeout(() => {
if (Math.random() > 0.5) dtd.resolve("成功");
else dtd.reject("失敗");
}, 1000);
return dtd.promise();
};
$.when(task(dtd))
.done(msg => console.log(msg))
.fail(msg => console.error(msg));
const dtd = $.Deferred();
const promise = dtd.promise(); // 只能 done/fail/always,不能 resolve/reject
promise.done(() => console.log("OK"));
// promise.resolve(); // ❌ TypeError: not a function
// 內部仍可用 dtd.resolve() 控制
setTimeout(() => dtd.resolve(), 1000);
function upload(files) {
const dtd = $.Deferred();
files.forEach((file, i) => {
// 模擬上傳進度
setTimeout(() => dtd.notify(i + 1, files.length), i * 200);
});
setTimeout(() => dtd.resolve("全部完成"), files.length * 200);
return dtd.promise();
}
upload([1,2,3]).progress((done, total) => {
console.log(`進度:${done}/${total}`);
}).done(msg => console.log(msg));
// 非 Promise 值會被視為已解析
$.when(42, "hello", $.ajax("...")).done((a, b, ajaxResp) => {
console.log(a, b); // 42, "hello"
});
// 等效原生寫法
function wait(ms) {
return new Promise(resolve => setTimeout(resolve, ms));
}
async function loadAll() {
try {
const [users, posts] = await Promise.all([
fetch("/api/users").then(r => r.json()),
fetch("/api/posts").then(r => r.json())
]);
render(users, posts);
} catch (e) {
alert("載入失敗");
}
}
| jQuery Deferred | 原生 Promise | 說明 |
|---|---|---|
| $.Deferred() | new Promise((resolve,reject)=>{}) | 建立可控制的非同步工作 |
| dtd.resolve() | resolve() | 標記成功 |
| dtd.reject() | reject() | 標記失敗 |
| dtd.promise() | Promise 本身 | 回傳受限介面 |
| .done/.fail/.always | .then/.catch/.finally | 綁定回調 |
| $.when(p1,p2) | Promise.all([p1,p2]) | 並行等待 |
| dtd.notify() | 無直接對應 | 進度通知(jQuery 專有) |
**建議**:新專案優先使用原生 `Promise`/`async-await`;維護舊專案時,Deferred 提供相容的 Promise-like 介面,掌握其狀態機制即可無縫銜接。