Promise 最早是 CommonJS 工作組為非同步程式設計提出的統一介面,ECMAScript 6 之後成為語言的原生標準。它的價值在兩點:一是避免回呼函式層層嵌套造成的「回呼地獄」,二是提供了一套規範明確的方式來控制非同步流程。核心方法包括 resolve、reject、then 與 catch。
ES6 之後 Promise 已是原生物件,直接實例化即可使用:
var promise = new Promise(function (resolve, reject) {
console.log('begin do something');
if (Math.random() * 10.0 > 5) {
console.log(" run success");
resolve(); // 成功
} else {
console.log(" run failed");
reject(); // 失敗
}
});
建構時傳入一個帶有 resolve 與 reject 兩個參數的回呼:任務成功呼叫 resolve,失敗呼叫 reject。
接著用 Promise.prototype.then 註冊完成後的回呼,兩個參數分別對應成功與失敗:
promise.then(function () {
console.log(' resolve from promise');
}, function () {
console.log(' reject from promise');
});
執行結果(成功時):
begin do something run success resolve from promise
執行結果(失敗時):
begin do something run failed reject from promise
把回呼風格的 API 包成 Promise,呼叫端就能用鏈式寫法處理結果與錯誤:
getRequest = function (url) {
var promise = new Promise(function (resolve, reject) {
var request = require('request');
request(url, function (error, respones, body) {
if (error) {
reject(error);
return;
}
if (respones.statusCode == 200) {
resolve(body);
} else {
reject(respones.status);
}
});
});
return promise;
};
getRequest("https://github.com/").then(function (result) {
console.log(result);
}, function (error) {
console.error('error', error);
});
同樣的模式也可以搬到瀏覽器上,用來包裝 Ajax 請求。
catch 取代第二個 then 參數。寫成 then(...).catch(...) 可以一次攔下前面整條鏈上任何一環丟出的錯誤,比在每個 then 裡各寫一份失敗回呼更乾淨。Promise.all,全部成功才 resolve;Promise.race 則是誰先完成就用誰的結果,很適合做逾時控制。return。在 then 裡回傳值或另一個 Promise,才能串起下一環;漏掉 return 是新手最常踩的坑。respones 是 response 的拼字錯誤,實作時記得修正,否則永遠取不到狀態碼。程式碼來源:https://github.com/jjz/node