瀏覽器的地理位置 API 就是 Promise 思想的典型體現:你發起請求,成功或失敗通過回調通知。
function success(position) {
var cords = position.coords;
console.log(cords.latitude + cords.longitude);
}
function error(err) {
console.warn(err.code + err.message);
}
navigator.geolocation.getCurrentPosition(success, error);
如果有一串異步任務需要按序執行:async1(success, failure), async2(...), ... asyncN(...),最直觀的寫法是回調嵌套:
async1(function () {
async2(function () {
// ...
asyncN(null, null);
}, null);
}, null);
這種「回調地獄」很難維護。另一種思路是計數,等所有異步任務都完成後再發出通知:
var counter = N;
function success() {
counter--;
if (counter === 0) { alert('done'); }
}
async1(success);
async2(success);
// ...
asyncN(success);
Deferred 表示異步操作的結果,提供查看操作狀態與結果的接口,並能生成對應的 promise 實例。Deferred 是可以改變操作狀態的。
Promise 則提供一個與該 deferred 交互的接口,用於註冊回調。
狀態流轉很清晰:創建 deferred 相當於 pending;執行 resolve 相當於 resolved;執行 reject 相當於 rejected。回調函數在得到狀態提示後開始執行,異步方法本身不需要知道回調怎麼處理結果,只負責在時機到來時改變狀態。
創建 deferred:
var myFirstDeferred = $q.defer();
在異步函數中改變它的狀態:
async(function (value) {
myFirstDeferred.resolve(value);
}, function (errorReason) {
myFirstDeferred.reject(errorReason);
});
在 AngularJS 中,$q 的 resolve 與 reject 不依賴上下文,可以直接傳引用:
async(myFirstDeferred.resolve, myFirstDeferred.reject);
使用 promise 註冊回調,一個 deferred 可以對應多個 promise:
var myFirstPromise = myFirstDeferred.promise;
myFirstPromise.then(function (data) {}, function (error) {});
var anotherDeferred = $q.defer();
anotherDeferred.promise.then(function (data) {}, function (error) {});
async(anotherDeferred.resolve, anotherDeferred.reject);
anotherDeferred.promise.then(function (data) {}, function (error) {});
function getData() {
var deferred = $q.defer();
async(deferred.resolve, deferred.reject);
return deferred.promise;
}
var dataPromise = getData();
dataPromise.then(function (data) {
console.log('success');
}, function (error) {
console.log('error');
});
只關心成功:只傳第一個回調。只關心失敗:傳 null 或直接用 catch。
dataPromise.then(function (data) { console.log('success'); });
dataPromise.then(null, function (error) { console.log('error'); });
dataPromise.catch(function (error) { console.log('error'); });
無論成功失敗都要收尾:用 finally。
var finalCallback = function () { console.log('不管成功或失敗都執行'); };
dataPromise.then(finalCallback, finalCallback);
// 或
dataPromise.finally(finalCallback);
function async(value) {
var deferred = $q.defer();
deferred.resolve(value / 2);
return deferred.promise;
}
var promise = async(8)
.then(function (x) { return x + 1; })
.then(function (x) { return x * 2; });
promise.then(function (x) { console.log(x); });
上一環 resolve 出的值成為下一環 then 的實參。若 then 中返回的是另一個 promise,它會被自動展開:
function async1(value) {
var deferred = $q.defer();
deferred.resolve(value * 2);
return deferred.promise;
}
function async2(value) {
var deferred = $q.defer();
deferred.resolve(value + 1);
return deferred.promise;
}
async1(10)
.then(function (x) { return async2(x); })
.then(function (x) { console.log(x); });
// 更易讀的等價寫法
async1(10).then(async2).then(logValue);
// 從異常捕獲角度
async1().then(async2).then(async3).catch(handleReject).finally(freeResources);
$q.reject(reason):讓鏈條進入 error 狀態並附上原因。
var promise = async().then(function (value) {
if (true) {
return value;
} else {
return $q.reject('value is not satisfied');
}
});
$q.when(value):把普通值包裝成已完成的 promise,常用於同步/異步返回值的統一:
function getDataFromBackend(query) {
var data = searchInCache(query);
if (data) {
return $q.when(data);
} else {
return makeAsyncBackendCall(query);
}
}
$q.all(promisesArr):等待所有 promise 完成後統一處理:
var allPromise = $q.all([async1(), async2() /* , ... , asyncN() */]);
allPromise.then(function (values) {
var value1 = values[0], value2 = values[1];
console.log('all done');
});
值得補充的是,AngularJS 的 $q 已被標準 ES6 Promise 取代為主流選擇。原生 Promise 提供了 Promise.all、Promise.race、then/catch/finally 等對應能力,而在需要更強表達力的異步流程控制時,async/await 往往比長鏈式 then 更易讀。理解本文的狀態機模型,能幫你更快看懂這些新語法背後在做什麼。