同步程式碼易於閱讀除錯,異步程式碼則換來效能與靈活性。異步最大的特點是「不必等」,而 Promise 正是馴服這份複雜度的主流方案——大量現代 Web API 都已採用 Promise 作為基礎。
有趣的是,XMLHttpRequest 本身是異步的卻沒有用 Promise,反倒是不少較新的原生 API 直接以 Promise 設計:
Node.js 生態同樣深度依賴 Promise。可以確定的是,所有前端開發者遲早都會用到它。
var p = new Promise(function (resolve, reject) {
// 執行異步任務
if (/* 條件良好 */) {
resolve('Success!');
} else {
reject('Failure!');
}
});
p.then(function (result) {
// 處理成功結果
}).catch(function (err) {
// 處理失敗
});
構造器提供 resolve 與 reject 兩個函數,由開發者在回呼內部依執行結果手動呼叫。
function get(url) {
return new Promise(function (resolve, reject) {
var req = new XMLHttpRequest();
req.open('GET', url);
req.onload = function () {
// 注意:即使 404 也會觸發 onload,所以必須檢查狀態碼
if (req.status == 200) {
resolve(req.response);
} else {
reject(Error(req.statusText));
}
};
req.onerror = function () {
reject(Error("Network Error"));
};
req.send();
});
}
get('story.json').then(function (response) {
console.log("Success!", response);
}, function (error) {
console.error("Failed!", error);
});
當你「確定要回傳一個已完成的 Promise」而不需要真的走 new 流程時,這兩個靜態方法可以省下不少字:
var userCache = {};
function getUserDetail(username) {
if (userCache[username]) {
// 命中快取,直接回傳已 resolve 的 Promise
return Promise.resolve(userCache[username]);
}
return fetch('users/' + username + '.json')
.then(function (result) {
userCache[username] = result;
return result;
})
.catch(function () {
throw new Error('Could not find user: ' + username);
});
}
不管走哪個分支,呼叫方都能一律用 then / catch 處理,介面保持一致。
new Promise(function (resolve) {
setTimeout(function () { resolve(10); }, 3000);
}).then(function (num) {
console.log('first then: ', num); // 10
return num * 2;
}).then(function (num) {
console.log('second then: ', num); // 20
return num * 2;
}).then(function (num) {
console.log('last then: ', num); // 40
});
每個 then 回呼的參數,就是上一個 then 回呼的返回值;若上一環回傳的是 Promise,下一環會等它 settle 後才繼續。這正是 Promise 消滅「回呼地獄」的機制。
另一個特性:Promise 的狀態一旦確定便不可逆。若已 resolve,後續再掛 then 仍會執行;若已 reject,後掛的 then 成功回呼不會被觸發。
new Promise(function (resolve, reject) {
setTimeout(function () { reject('Done!'); }, 3000);
}).then(function (e) {
console.log('done', e);
}).catch(function (e) {
console.log('catch: ', e); // "catch: Done!"
});
慣例是傳 Error 物件而非裸字符串,這樣才有完整的堆疊資訊:
reject(Error('Data could not be found'));
另外 catch 也會攔下前面 then 回呼中拋出的例外,等價於 then(null, onRejected)。
需要並行發出多個請求、但希望等全部回來才做下一步時,這就是答案:
Promise.all([promise1, promise2])
.then(function (results) {
// 兩個都成功
})
.catch(function (error) {
// 其中任一被拒絕
});
var request1 = fetch('/users.json');
var request2 = fetch('/articles.json');
Promise.all([request1, request2]).then(function (results) {
// results 是依參數順序排列的回應陣列
});
不同 API 也能混用,因為它們都回傳 Promise:
Promise.all([fetch('/users.json'), navigator.getBattery()])
.then(function (results) { /* 都完成了 */ });
只要有一個 reject,catch 就會抓到「最先」被拒絕的那個:
var req1 = new Promise(function (resolve) {
setTimeout(function () { resolve('First!'); }, 4000);
});
var req2 = new Promise(function (resolve, reject) {
setTimeout(function () { reject('Second!'); }, 3000);
});
Promise.all([req1, req2])
.then(function (results) { console.log('Then: ', results); })
.catch(function (err) { console.log('Catch: ', err); });
// Catch: Second!
要注意的是,Promise.all 失敗時其他已成功的結果會被丟棄。若需要「容錯版」的等待全部結果,可自行實作 allSettled 邏輯(ES2020 已內建 Promise.allSettled)。
var req1 = new Promise(function (resolve) {
setTimeout(function () { resolve('First!'); }, 8000);
});
var req2 = new Promise(function (resolve) {
setTimeout(function () { resolve('Second!'); }, 3000);
});
Promise.race([req1, req2]).then(function (one) {
console.log('Then: ', one); // Second!
});
它不等全部,只要有一個 settle 就立刻回傳該結果(成功或失敗都算)。典型用途是從多個鏡像節點同時抓資源、誰先回就用誰,或是實作請求逾時:
function withTimeout(promise, ms) {
var timeout = new Promise(function (resolve, reject) {
setTimeout(function () { reject(Error('Timeout')); }, ms);
});
return Promise.race([promise, timeout]);
}
Promise 從一個技術名詞演變成 JavaScript 語言架構的一部分,後續的 async/await 更是直接建立在它之上——await 背後等的就是一個 Promise。理解 then 串接、狀態不可逆、以及 all / race 的組合語意,等於掌握了現代非同步程式設計的基礎。往後看到越多新的 Web API 以 Promise 形式出現,你都不會感到陌生。