00漠吻、前言
Promise 是異步編程的一種解決方案量瓜,比傳統(tǒng)的解決方案——回調(diào)函數(shù)和事件——更合理和更強(qiáng)大。它由社區(qū)最早提出和實(shí)現(xiàn)途乃,ES6 將其寫(xiě)進(jìn)了語(yǔ)言標(biāo)準(zhǔn)绍傲,統(tǒng)一了用法,原生提供了Promise對(duì)象耍共。
所謂Promise烫饼,簡(jiǎn)單說(shuō)就是一個(gè)容器,里面保存著某個(gè)未來(lái)才會(huì)結(jié)束的事件(通常是一個(gè)異步操作)的結(jié)果试读。從語(yǔ)法上說(shuō)杠纵,Promise 是一個(gè)對(duì)象耗绿,從它可以獲取異步操作的消息欲低。Promise 提供統(tǒng)一的 API狰贯,各種異步操作都可以用同樣的方法進(jìn)行處理街佑。
Promise對(duì)象有以下兩個(gè)特點(diǎn)狼速。
(1)對(duì)象的狀態(tài)不受外界影響蓖宦。Promise對(duì)象代表一個(gè)異步操作艺骂,有三種狀態(tài):pending(進(jìn)行中)藕坯、fulfilled(已成功)和rejected(已失斕破佟)群凶。只有異步操作的結(jié)果,可以決定當(dāng)前是哪一種狀態(tài)哄辣,任何其他操作都無(wú)法改變這個(gè)狀態(tài)请梢。這也是Promise這個(gè)名字的由來(lái),它的英語(yǔ)意思就是“承諾”力穗,表示其他手段無(wú)法改變毅弧。
(2)一旦狀態(tài)改變,就不會(huì)再變当窗,任何時(shí)候都可以得到這個(gè)結(jié)果够坐。Promise對(duì)象的狀態(tài)改變,只有兩種可能:從pending變?yōu)閒ulfilled和從pending變?yōu)閞ejected崖面。只要這兩種情況發(fā)生元咙,狀態(tài)就凝固了,不會(huì)再變了巫员,會(huì)一直保持這個(gè)結(jié)果庶香,這時(shí)就稱(chēng)為 resolved(已定型)。如果改變已經(jīng)發(fā)生了简识,你再對(duì)Promise對(duì)象添加回調(diào)函數(shù)赶掖,也會(huì)立即得到這個(gè)結(jié)果感猛。這與事件(Event)完全不同,事件的特點(diǎn)是奢赂,如果你錯(cuò)過(guò)了它陪白,再去監(jiān)聽(tīng),是得不到結(jié)果的呈驶。
注意拷泽,為了行文方便,本章后面的resolved統(tǒng)一只指fulfilled狀態(tài)袖瞻,不包含rejected狀態(tài)。
有了Promise
對(duì)象拆吆,就可以將異步操作以同步操作的流程表達(dá)出來(lái)聋迎,避免了層層嵌套的回調(diào)函數(shù)。此外枣耀,Promise
對(duì)象提供統(tǒng)一的接口霉晕,使得控制異步操作更加容易。
Promise
也有一些缺點(diǎn)捞奕。首先牺堰,無(wú)法取消Promise
,一旦新建它就會(huì)立即執(zhí)行颅围,無(wú)法中途取消伟葫。其次,如果不設(shè)置回調(diào)函數(shù)院促,Promise
內(nèi)部拋出的錯(cuò)誤筏养,不會(huì)反應(yīng)到外部。第三常拓,當(dāng)處于pending
狀態(tài)時(shí)渐溶,無(wú)法得知目前進(jìn)展到哪一個(gè)階段(剛剛開(kāi)始還是即將完成)。
如果某些事件不斷地反復(fù)發(fā)生弄抬,一般來(lái)說(shuō)茎辐,使用 Stream 模式是比部署Promise
更好的選擇。
01掂恕、基本用法
ES6 規(guī)定拖陆,Promise對(duì)象是一個(gè)構(gòu)造函數(shù),用來(lái)生成Promise實(shí)例
var promise = new Promise(function(resolve, reject) {
// ... some code
if (/* 異步操作成功 */){
resolve(value);
} else {
reject(error);
}
});
Promise構(gòu)造函數(shù)接受一個(gè)函數(shù)作為參數(shù)竹海,該函數(shù)的兩個(gè)參數(shù)分別是resolve和reject慕蔚。它們是兩個(gè)函數(shù),由 JavaScript 引擎提供斋配,不用自己部署孔飒。
resolve函數(shù)的作用是灌闺,將Promise對(duì)象的狀態(tài)從“未完成”變?yōu)椤俺晒Α保磸?pending 變?yōu)?resolved),在異步操作成功時(shí)調(diào)用坏瞄,并將異步操作的結(jié)果桂对,作為參數(shù)傳遞出去;reject函數(shù)的作用是鸠匀,將Promise對(duì)象的狀態(tài)從“未完成”變?yōu)椤笆 保磸?pending 變?yōu)?rejected)蕉斜,在異步操作失敗時(shí)調(diào)用,并將異步操作報(bào)出的錯(cuò)誤缀棍,作為參數(shù)傳遞出去宅此。
Promise實(shí)例生成以后,可以用then方法分別指定resolved狀態(tài)和rejected狀態(tài)的回調(diào)函數(shù)
promise.then(function(value) {
// success
}, function(error) {
// failure
});
then方法可以接受兩個(gè)回調(diào)函數(shù)作為參數(shù)爬范。第一個(gè)回調(diào)函數(shù)是Promise對(duì)象的狀態(tài)變?yōu)閞esolved時(shí)調(diào)用父腕,第二個(gè)回調(diào)函數(shù)是Promise對(duì)象的狀態(tài)變?yōu)閞ejected時(shí)調(diào)用。其中青瀑,第二個(gè)函數(shù)是可選的璧亮,不一定要提供。這兩個(gè)函數(shù)都接受Promise對(duì)象傳出的值作為參數(shù)斥难。
function timeout(ms) {
return new Promise((res, rej) => {
// setTimeout(res, ms, 'done')
setTimeout(rej, ms, 'rej')
})
}
timeout(1000).then((val) => {
console.log(val)
},(val) =>{
console.log(val)
})
上面代碼中枝嘶,timeout方法返回一個(gè)Promise實(shí)例,表示一段時(shí)間以后才會(huì)發(fā)生的結(jié)果哑诊。過(guò)了指定的時(shí)間(ms參數(shù))以后群扶,Promise實(shí)例的狀態(tài)變?yōu)閞esolved,就會(huì)觸發(fā)then方法綁定的回調(diào)函數(shù)
Promise 新建后就會(huì)立即執(zhí)行搭儒。
let promise = new Promise(function(resolve, reject) {
console.log('Promise');
resolve();
});
promise.then(function() {
console.log('resolved.');
});
console.log('Hi!');
// Promise
// Hi!
// resolved
上面代碼中穷当,Promise 新建后立即執(zhí)行,所以首先輸出的是Promise淹禾。然后馁菜,then方法指定的回調(diào)函數(shù),將在當(dāng)前腳本所有同步任務(wù)執(zhí)行完才會(huì)執(zhí)行铃岔,所以resolved最后輸出
下面是異步加載圖片的例子汪疮。
function loadImageAsync(url) {
return new Promise(function(resolve, reject) {
var image = new Image();
image.onload = function() {
resolve(image);
};
image.onerror = function() {
reject(new Error('Could not load image at ' + url));
};
image.src = url;
});
}
上面代碼中,使用Promise包裝了一個(gè)圖片加載的異步操作毁习。如果加載成功智嚷,就調(diào)用resolve方法,否則就調(diào)用reject方法纺且。
下面是一個(gè)用Promise對(duì)象實(shí)現(xiàn)的 Ajax 操作的例子盏道。
var getJSON = function(url) {
var promise = new Promise(function(resolve, reject){
var client = new XMLHttpRequest();
client.open("GET", url);
client.onreadystatechange = handler;
client.responseType = "json";
client.setRequestHeader("Accept", "application/json");
client.send();
function handler() {
if (this.readyState !== 4) {
return;
}
if (this.status === 200) {
resolve(this.response);
} else {
reject(new Error(this.statusText));
}
};
});
return promise;
};
getJSON("/posts.json").then(function(json) {
console.log('Contents: ' + json);
}, function(error) {
console.error('出錯(cuò)了', error);
});
上面代碼中,getJSON是對(duì) XMLHttpRequest 對(duì)象的封裝载碌,用于發(fā)出一個(gè)針對(duì) JSON 數(shù)據(jù)的 HTTP 請(qǐng)求猜嘱,并且返回一個(gè)Promise對(duì)象衅枫。需要注意的是,在getJSON內(nèi)部朗伶,resolve函數(shù)和reject函數(shù)調(diào)用時(shí)弦撩,都帶有參數(shù)
下邊的是axios請(qǐng)求的封裝
export function fetch (url, params) {
return new Promise((resolve, reject) => {
axios.post(url, params)
.then(response => {
console.log('api-res')
console.log(response.data)
if (response.data.code === 0) {
resolve(response.data)
} else {
console.log('數(shù)據(jù)請(qǐng)求返回錯(cuò)誤')
}
// resolve(response.data)
}, err => {
console.log('err錯(cuò)誤')
console.log(err.data.message)
reject(err)
})
.catch((error) => {
console.log('error錯(cuò)誤')
reject(error)
})
})
}
如果調(diào)用resolve函數(shù)和reject函數(shù)時(shí)帶有參數(shù),那么它們的參數(shù)會(huì)被傳遞給回調(diào)函數(shù)论皆。reject函數(shù)的參數(shù)通常是Error對(duì)象的實(shí)例益楼,表示拋出的錯(cuò)誤;resolve函數(shù)的參數(shù)除了正常的值以外点晴,還可能是另一個(gè) Promise 實(shí)例感凤,比如像下面這樣。
var p1 = new Promise(function (resolve, reject) {
// ...
});
var p2 = new Promise(function (resolve, reject) {
// ...
resolve(p1);
})
上面代碼中觉鼻,p1和p2都是 Promise 的實(shí)例俊扭,但是p2的resolve方法將p1作為參數(shù),即一個(gè)異步操作的結(jié)果是返回另一個(gè)異步操作坠陈。
注意,這時(shí)p1的狀態(tài)就會(huì)傳遞給p2捐康,也就是說(shuō)仇矾,p1的狀態(tài)決定了p2的狀態(tài)。如果p1的狀態(tài)是pending解总,那么p2的回調(diào)函數(shù)就會(huì)等待p1的狀態(tài)改變贮匕;如果p1的狀態(tài)已經(jīng)是resolved或者rejected,那么p2的回調(diào)函數(shù)將會(huì)立刻執(zhí)行花枫。
var p1 = new Promise(function (resolve, reject) {
setTimeout(() => reject(new Error('fail')), 3000)
})
var p2 = new Promise(function (resolve, reject) {
setTimeout(() => resolve(p1), 1000)
})
p2
.then(result => console.log(result))
.catch(error => console.log(error))
// Error: fail
上面代碼中刻盐,p1是一個(gè)Promise,3秒之后變?yōu)閞ejected劳翰。p2的狀態(tài)在1秒之后改變敦锌,resolve方法返回的是p1。由于p2返回的是另一個(gè) Promise佳簸,導(dǎo)致p2自己的狀態(tài)無(wú)效了乙墙,由p1的狀態(tài)決定p2的狀態(tài)。所以生均,后面的then語(yǔ)句都變成針對(duì)后者(p1)听想。又過(guò)了2秒,p1變?yōu)閞ejected马胧,導(dǎo)致觸發(fā)catch方法指定的回調(diào)函數(shù)汉买。
注意,調(diào)用resolve或reject并不會(huì)終結(jié) Promise 的參數(shù)函數(shù)的執(zhí)行
new Promise((resolve, reject) => {
resolve(1);
console.log(2);
}).then(r => {
console.log(r);
});
// 2
// 1
上面代碼中佩脊,調(diào)用resolve(1)以后蛙粘,后面的console.log(2)還是會(huì)執(zhí)行垫卤,并且會(huì)首先打印出來(lái)。這是因?yàn)榱⒓?resolved 的 Promise 是在本輪事件循環(huán)的末尾執(zhí)行组题,總是晚于本輪循環(huán)的同步任務(wù)葫男。
一般來(lái)說(shuō),調(diào)用resolve或reject以后崔列,Promise 的使命就完成了梢褐,后繼操作應(yīng)該放到then方法里面,而不應(yīng)該直接寫(xiě)在resolve或reject的后面赵讯。所以盈咳,最好在它們前面加上return語(yǔ)句,這樣就不會(huì)有意外边翼。
let promise = new Promise((res, rej) => {
console.log(1)
return res(2)
// 后面的語(yǔ)句不會(huì)執(zhí)行
console.log('Promise')
})
promise.then((res) => {
console.log('res')
console.log(res)
})
02鱼响、Promise.prototype.then()
Promise 實(shí)例具有then方法,也就是說(shuō)组底,then方法是定義在原型對(duì)象Promise.prototype上的丈积。它的作用是為 Promise 實(shí)例添加狀態(tài)改變時(shí)的回調(diào)函數(shù)。前面說(shuō)過(guò)债鸡,then方法的第一個(gè)參數(shù)是resolved狀態(tài)的回調(diào)函數(shù)江滨,第二個(gè)參數(shù)(可選)是rejected狀態(tài)的回調(diào)函數(shù)。
then方法返回的是一個(gè)新的Promise實(shí)例(注意厌均,不是原來(lái)那個(gè)Promise實(shí)例)唬滑。因此可以采用鏈?zhǔn)綄?xiě)法,即then方法后面再調(diào)用另一個(gè)then方法棺弊。
getJSON("/posts.json").then(function(json) {
return json.post;
}).then(function(post) {
// ...
});
上面的代碼使用then方法晶密,依次指定了兩個(gè)回調(diào)函數(shù)。第一個(gè)回調(diào)函數(shù)完成以后模她,會(huì)將返回結(jié)果作為參數(shù)稻艰,傳入第二個(gè)回調(diào)函數(shù)。
采用鏈?zhǔn)降膖hen缝驳,可以指定一組按照次序調(diào)用的回調(diào)函數(shù)连锯。這時(shí),前一個(gè)回調(diào)函數(shù)用狱,有可能返回的還是一個(gè)Promise對(duì)象(即有異步操作)运怖,這時(shí)后一個(gè)回調(diào)函數(shù),就會(huì)等待該P(yáng)romise對(duì)象的狀態(tài)發(fā)生變化夏伊,才會(huì)被調(diào)用摇展。
上面代碼中,第一個(gè)then方法指定的回調(diào)函數(shù)溺忧,返回的是另一個(gè)Promise對(duì)象咏连。這時(shí)盯孙,第二個(gè)then方法指定的回調(diào)函數(shù),就會(huì)等待這個(gè)新的Promise對(duì)象狀態(tài)發(fā)生變化祟滴。如果變?yōu)閞esolved振惰,就調(diào)用funcA,如果狀態(tài)變?yōu)閞ejected垄懂,就調(diào)用funcB骑晶。
如果采用箭頭函數(shù),上面的代碼可以寫(xiě)得更簡(jiǎn)潔草慧。
getJSON("/post/1.json").then(
post => getJSON(post.commentURL)
).then(
comments => console.log("resolved: ", comments),
err => console.log("rejected: ", err)
);
3桶蛔、Promise.prototype.catch()
Promise.prototype.catch方法是.then(null, rejection)的別名,用于指定發(fā)生錯(cuò)誤時(shí)的回調(diào)函數(shù)漫谷。
getJSON('/posts.json').then(function(posts) {
// ...
}).catch(function(error) {
// 處理 getJSON 和 前一個(gè)回調(diào)函數(shù)運(yùn)行時(shí)發(fā)生的錯(cuò)誤
console.log('發(fā)生錯(cuò)誤仔雷!', error);
});
上面代碼中,getJSON方法返回一個(gè) Promise 對(duì)象舔示,如果該對(duì)象狀態(tài)變?yōu)閞esolved碟婆,則會(huì)調(diào)用then方法指定的回調(diào)函數(shù);如果異步操作拋出錯(cuò)誤惕稻,狀態(tài)就會(huì)變?yōu)閞ejected脑融,就會(huì)調(diào)用catch方法指定的回調(diào)函數(shù),處理這個(gè)錯(cuò)誤缩宜。另外,then方法指定的回調(diào)函數(shù)甥温,如果運(yùn)行中拋出錯(cuò)誤锻煌,也會(huì)被catch方法捕獲。
p.then((val) => console.log('fulfilled:', val))
.catch((err) => console.log('rejected', err));
// 等同于
p.then((val) => console.log('fulfilled:', val))
.then(null, (err) => console.log("rejected:", err));
例子:
let promise = new Promise(() => {
throw new Error('test')
})
promise.catch((err) => {
console.log(err)
})
上面代碼中姻蚓,promise拋出一個(gè)錯(cuò)誤宋梧,就被catch方法指定的回調(diào)函數(shù)捕獲。注意狰挡,上面的寫(xiě)法與下面兩種寫(xiě)法是等價(jià)的捂龄。
// 寫(xiě)法一
var promise = new Promise(function(resolve, reject) {
try {
throw new Error('test');
} catch(e) {
reject(e);
}
});
promise.catch(function(error) {
console.log(error);
});
// 寫(xiě)法二
var promise = new Promise(function(resolve, reject) {
reject(new Error('test'));
});
promise.catch(function(error) {
console.log(error);
});
比較上面兩種寫(xiě)法,可以發(fā)現(xiàn)reject方法的作用加叁,等同于拋出錯(cuò)誤倦沧。
如果Promise狀態(tài)已經(jīng)變成resolved,再拋出錯(cuò)誤是無(wú)效的它匕。
var promise = new Promise(function(resolve, reject) {
resolve('ok');
throw new Error('test');
});
promise
.then(function(value) { console.log(value) })
.catch(function(error) { console.log(error) });
// ok
上面代碼中展融,Promise 在resolve語(yǔ)句后面,再拋出錯(cuò)誤豫柬,不會(huì)被捕獲告希,等于沒(méi)有拋出扑浸。因?yàn)?Promise 的狀態(tài)一旦改變,就永久保持該狀態(tài)燕偶,不會(huì)再變了喝噪。
Promise 對(duì)象的錯(cuò)誤具有“冒泡”性質(zhì),會(huì)一直向后傳遞指么,直到被捕獲為止酝惧。也就是說(shuō),錯(cuò)誤總是會(huì)被下一個(gè)catch語(yǔ)句捕獲涧尿。
getJSON('/post/1.json').then(function(post) {
return getJSON(post.commentURL);
}).then(function(comments) {
// some code
}).catch(function(error) {
// 處理前面三個(gè)Promise產(chǎn)生的錯(cuò)誤
});
上面代碼中系奉,一共有三個(gè)Promise對(duì)象:一個(gè)由getJSON產(chǎn)生,兩個(gè)由then產(chǎn)生姑廉。它們之中任何一個(gè)拋出的錯(cuò)誤缺亮,都會(huì)被最后一個(gè)catch捕獲。
一般來(lái)說(shuō)桥言,不要在then方法里面定義Reject狀態(tài)的回調(diào)函數(shù)(即then的第二個(gè)參數(shù))萌踱,總是使用catch方法。
// bad
promise
.then(function(data) {
// success
}, function(err) {
// error
});
// good
promise
.then(function(data) { //cb
// success
})
.catch(function(err) {
// error
});
上面代碼中号阿,第二種寫(xiě)法要好于第一種寫(xiě)法并鸵,理由是第二種寫(xiě)法可以捕獲前面then方法執(zhí)行中的錯(cuò)誤,也更接近同步的寫(xiě)法(try/catch)扔涧。因此园担,建議總是使用catch方法,而不使用then方法的第二個(gè)參數(shù)枯夜。
const someAsyncThing = function() {
return new Promise(function(resolve, reject) {
// 下面一行會(huì)報(bào)錯(cuò)弯汰,因?yàn)閤沒(méi)有聲明
resolve(x + 2);
});
};
someAsyncThing().then(function() {
console.log('everything is great');
});
setTimeout(() => { console.log(123) }, 2000);
// Uncaught (in promise) ReferenceError: x is not defined
// 123
上面代碼中,someAsyncThing函數(shù)產(chǎn)生的 Promise 對(duì)象湖雹,內(nèi)部有語(yǔ)法錯(cuò)誤咏闪。瀏覽器運(yùn)行到這一行,會(huì)打印出錯(cuò)誤提示ReferenceError: x is not defined摔吏,但是不會(huì)退出進(jìn)程鸽嫂、終止腳本執(zhí)行,2秒之后還是會(huì)輸出123征讲。這就是說(shuō)据某,Promise 內(nèi)部的錯(cuò)誤不會(huì)影響到 Promise 外部的代碼,通俗的說(shuō)法就是“Promise 會(huì)吃掉錯(cuò)誤”稳诚。
這個(gè)腳本放在服務(wù)器執(zhí)行哗脖,退出碼就是0(即表示執(zhí)行成功)。不過(guò),Node 有一個(gè)unhandledRejection事件才避,專(zhuān)門(mén)監(jiān)聽(tīng)未捕獲的reject錯(cuò)誤橱夭,上面的腳本會(huì)觸發(fā)這個(gè)事件的監(jiān)聽(tīng)函數(shù),可以在監(jiān)聽(tīng)函數(shù)里面拋出錯(cuò)誤桑逝。
process.on('unhandledRejection', function (err, p) {
throw err;
});
上面代碼中棘劣,unhandledRejection事件的監(jiān)聽(tīng)函數(shù)有兩個(gè)參數(shù),第一個(gè)是錯(cuò)誤對(duì)象楞遏,第二個(gè)是報(bào)錯(cuò)的 Promise 實(shí)例茬暇,它可以用來(lái)了解發(fā)生錯(cuò)誤的環(huán)境信息。
注意寡喝,Node 有計(jì)劃在未來(lái)廢除unhandledRejection事件糙俗。如果 Promise 內(nèi)部有未捕獲的錯(cuò)誤,會(huì)直接終止進(jìn)程预鬓,并且進(jìn)程的退出碼不為0巧骚。
看看下邊的例子
var promise = new Promise(function (resolve, reject) {
resolve('ok');
setTimeout(function () { throw new Error('test') }, 0)
});
promise.then(function (value) { console.log(value) });
// ok
// Uncaught Error: test
上面代碼中,Promise 指定在下一輪“事件循環(huán)”再拋出錯(cuò)誤格二。到了那個(gè)時(shí)候劈彪,Promise 的運(yùn)行已經(jīng)結(jié)束了,所以這個(gè)錯(cuò)誤是在 Promise 函數(shù)體外拋出的顶猜,會(huì)冒泡到最外層沧奴,成了未捕獲的錯(cuò)誤。
一般總是建議长窄,Promise 對(duì)象后面要跟catch方法滔吠,這樣可以處理 Promise 內(nèi)部發(fā)生的錯(cuò)誤。catch方法返回的還是一個(gè) Promise 對(duì)象挠日,因此后面還可以接著調(diào)用then方法
var someAsyncThing = function() {
return new Promise(function(resolve, reject) {
// 下面一行會(huì)報(bào)錯(cuò)屠凶,因?yàn)閤沒(méi)有聲明
resolve(x + 2);
});
};
someAsyncThing()
.catch(function(error) {
console.log('oh no', error);
})
.then(function() {
console.log('carry on');
});
// oh no [ReferenceError: x is not defined]
// carry on
上面代碼運(yùn)行完catch方法指定的回調(diào)函數(shù),會(huì)接著運(yùn)行后面那個(gè)then方法指定的回調(diào)函數(shù)肆资。如果沒(méi)有報(bào)錯(cuò),則會(huì)跳過(guò)catch方法灶芝。
Promise.resolve()
.catch(function(error) {
console.log('oh no', error);
})
.then(function() {
console.log('carry on');
});
// carry on
上面的代碼因?yàn)闆](méi)有報(bào)錯(cuò)郑原,跳過(guò)了catch方法,直接執(zhí)行后面的then方法夜涕。此時(shí)犯犁,要是then方法里面報(bào)錯(cuò),就與前面的catch無(wú)關(guān)了女器。
catch方法之中酸役,還能再拋出錯(cuò)誤
var someAsyncThing = function() {
return new Promise(function(resolve, reject) {
// 下面一行會(huì)報(bào)錯(cuò),因?yàn)閤沒(méi)有聲明
resolve(x + 2);
});
};
someAsyncThing().then(function() {
return someOtherAsyncThing();
}).catch(function(error) {
console.log('oh no', error);
// 下面一行會(huì)報(bào)錯(cuò),因?yàn)?y 沒(méi)有聲明
y + 2;
}).then(function() {
console.log('carry on');
});
// oh no [ReferenceError: x is not defined]
上面代碼中涣澡,catch方法拋出一個(gè)錯(cuò)誤贱呐,因?yàn)楹竺鏇](méi)有別的catch方法了,導(dǎo)致這個(gè)錯(cuò)誤不會(huì)被捕獲入桂,也不會(huì)傳遞到外層奄薇。如果改寫(xiě)一下,結(jié)果就不一樣了抗愁。
someAsyncThing().then(function() {
return someOtherAsyncThing();
}).catch(function(error) {
console.log('oh no', error);
// 下面一行會(huì)報(bào)錯(cuò)馁蒂,因?yàn)閥沒(méi)有聲明
y + 2;
}).catch(function(error) {
console.log('carry on', error);
});
// oh no [ReferenceError: x is not defined]
// carry on [ReferenceError: y is not defined]
上面代碼中,第二個(gè)catch方法用來(lái)捕獲蜘腌,前一個(gè)catch方法拋出的錯(cuò)誤沫屡。
4、Promise.all()
Promise.all方法用于將多個(gè) Promise 實(shí)例撮珠,包裝成一個(gè)新的 Promise 實(shí)例
var p = Promise.all([p1, p2, p3]);
上面代碼中沮脖,Promise.all方法接受一個(gè)數(shù)組作為參數(shù),p1劫瞳、p2倘潜、p3都是 Promise 實(shí)例,如果不是志于,就會(huì)先調(diào)用下面講到的Promise.resolve方法涮因,將參數(shù)轉(zhuǎn)為 Promise 實(shí)例,再進(jìn)一步處理伺绽。(Promise.all方法的參數(shù)可以不是數(shù)組养泡,但必須具有 Iterator 接口,且返回的每個(gè)成員都是 Promise 實(shí)例奈应。)
p的狀態(tài)由p1澜掩、p2、p3決定杖挣,分成兩種情況肩榕。
(1)只有p1、p2惩妇、p3的狀態(tài)都變成fulfilled株汉,p的狀態(tài)才會(huì)變成fulfilled,此時(shí)p1歌殃、p2乔妈、p3的返回值組成一個(gè)數(shù)組,傳遞給p的回調(diào)函數(shù)氓皱。
(2)只要p1路召、p2勃刨、p3之中有一個(gè)被rejected,p的狀態(tài)就變成rejected股淡,此時(shí)第一個(gè)被reject的實(shí)例的返回值身隐,會(huì)傳遞給p的回調(diào)函數(shù)。
看看下邊的例子
// 生成一個(gè)Promise對(duì)象的數(shù)組
var promises = [2, 3, 5, 7, 11, 13].map(function (id) {
return getJSON('/post/' + id + ".json");
});
Promise.all(promises).then(function (posts) {
// ...
}).catch(function(reason){
// ...
});
上面代碼中揣非,promises是包含6個(gè) Promise 實(shí)例的數(shù)組抡医,只有這6個(gè)實(shí)例的狀態(tài)都變成fulfilled,或者其中有一個(gè)變?yōu)閞ejected早敬,才會(huì)調(diào)用Promise.all方法后面的回調(diào)函數(shù)忌傻。
看看下邊的例子
const databasePromise = connectDatabase();
const booksPromise = databasePromise
.then(findAllBooks);
const userPromise = databasePromise
.then(getCurrentUser);
Promise.all([
booksPromise,
userPromise
])
.then(([books, user]) => pickTopRecommentations(books, user));
上面代碼中,booksPromise和userPromise是兩個(gè)異步操作搞监,只有等到它們的結(jié)果都返回了水孩,才會(huì)觸發(fā)pickTopRecommentations這個(gè)回調(diào)函數(shù)。
注意琐驴,如果作為參數(shù)的 Promise 實(shí)例俘种,自己定義了catch方法,那么它一旦被rejected绝淡,并不會(huì)觸發(fā)Promise.all()的catch方法宙刘。
const p1 = new Promise((resolve, reject) => {
resolve('hello');
})
.then(result => result)
.catch(e => e);
const p2 = new Promise((resolve, reject) => {
throw new Error('報(bào)錯(cuò)了');
})
.then(result => result)
.catch(e => e);
Promise.all([p1, p2])
.then(result => console.log(result))
.catch(e => console.log(e));
// ["hello", Error: 報(bào)錯(cuò)了]
上面代碼中,p1會(huì)resolved牢酵,p2首先會(huì)rejected悬包,但是p2有自己的catch方法,該方法返回的是一個(gè)新的 Promise 實(shí)例馍乙,p2指向的實(shí)際上是這個(gè)實(shí)例布近。該實(shí)例執(zhí)行完catch方法后,也會(huì)變成resolved丝格,導(dǎo)致Promise.all()方法參數(shù)里面的兩個(gè)實(shí)例都會(huì)resolved撑瞧,因此會(huì)調(diào)用then方法指定的回調(diào)函數(shù),而不會(huì)調(diào)用catch方法指定的回調(diào)函數(shù)显蝌。
如果p2沒(méi)有自己的catch方法预伺,就會(huì)調(diào)用Promise.all()的catch方法。
const p1 = new Promise((resolve, reject) => {
resolve('hello');
})
.then(result => result);
const p2 = new Promise((resolve, reject) => {
throw new Error('報(bào)錯(cuò)了');
})
.then(result => result);
Promise.all([p1, p2])
.then(result => console.log(result))
.catch(e => console.log(e));
// Error: 報(bào)錯(cuò)
5曼尊、Promise.race()
Promise.race方法同樣是將多個(gè)Promise實(shí)例扭屁,包裝成一個(gè)新的Promise實(shí)例
var p = Promise.race([p1, p2, p3]);
上面代碼中,只要p1涩禀、p2、p3之中有一個(gè)實(shí)例率先改變狀態(tài)然眼,p的狀態(tài)就跟著改變艾船。那個(gè)率先改變的 Promise 實(shí)例的返回值,就傳遞給p的回調(diào)函數(shù)。
Promise.race方法的參數(shù)與Promise.all方法一樣屿岂,如果不是 Promise 實(shí)例践宴,就會(huì)先調(diào)用下面講到的Promise.resolve方法,將參數(shù)轉(zhuǎn)為 Promise 實(shí)例爷怀,再進(jìn)一步處理阻肩。
下面是一個(gè)例子,如果指定時(shí)間內(nèi)沒(méi)有獲得結(jié)果运授,就將Promise的狀態(tài)變?yōu)閞eject烤惊,否則變?yōu)閞esolve。
const p = Promise.race([
fetch('/resource-that-may-take-a-while'),
new Promise(function (resolve, reject) {
setTimeout(() => reject(new Error('request timeout')), 5000)
})
]);
p.then(response => console.log(response));
p.catch(error => console.log(error));
上面代碼中吁朦,如果5秒之內(nèi)fetch方法無(wú)法返回結(jié)果柒室,變量p的狀態(tài)就會(huì)變?yōu)閞ejected,從而觸發(fā)catch方法指定的回調(diào)函數(shù)逗宜。
6雄右、Promise.resolve()
有時(shí)需要將現(xiàn)有對(duì)象轉(zhuǎn)為Promise對(duì)象,Promise.resolve方法就起到這個(gè)作用
var jsPromise = Promise.resolve($.ajax('/whatever.json'));
上面代碼將jQuery生成的deferred對(duì)象纺讲,轉(zhuǎn)為一個(gè)新的Promise對(duì)象擂仍。
Promise.resolve等價(jià)于下面的寫(xiě)法。
Promise.resolve('foo')
// 等價(jià)于
new Promise(resolve => resolve('foo'))
Promise.resolve方法的參數(shù)分成四種情況熬甚。
(1)參數(shù)是一個(gè)Promise實(shí)例
如果參數(shù)是Promise實(shí)例逢渔,那么Promise.resolve將不做任何修改、原封不動(dòng)地返回這個(gè)實(shí)例则涯。
(2)參數(shù)是一個(gè)thenable對(duì)象
thenable對(duì)象指的是具有then方法的對(duì)象复局,比如下面這個(gè)對(duì)象。
let thenable = {
then: function(resolve, reject) {
resolve(42);
}
};
Promise.resolve方法會(huì)將這個(gè)對(duì)象轉(zhuǎn)為Promise對(duì)象粟判,然后就立即執(zhí)行thenable對(duì)象的then方法亿昏。
let thenable = {
then: function(resolve, reject) {
resolve(42);
}
};
let p1 = Promise.resolve(thenable);
p1.then(function(value) {
console.log(value); // 42
});
上面代碼中,thenable對(duì)象的then方法執(zhí)行后档礁,對(duì)象p1的狀態(tài)就變?yōu)閞esolved角钩,從而立即執(zhí)行最后那個(gè)then方法指定的回調(diào)函數(shù),輸出42呻澜。
(3)參數(shù)不是具有then方法的對(duì)象递礼,或根本就不是對(duì)象
如果參數(shù)是一個(gè)原始值,或者是一個(gè)不具有then方法的對(duì)象羹幸,則Promise.resolve方法返回一個(gè)新的Promise對(duì)象脊髓,狀態(tài)為resolved。
var p = Promise.resolve('Hello');
p.then(function (s){
console.log(s)
});
// Hello
上面代碼生成一個(gè)新的Promise對(duì)象的實(shí)例p栅受。由于字符串Hello不屬于異步操作(判斷方法是字符串對(duì)象不具有then方法)将硝,返回Promise實(shí)例的狀態(tài)從一生成就是resolved恭朗,所以回調(diào)函數(shù)會(huì)立即執(zhí)行。Promise.resolve方法的參數(shù)依疼,會(huì)同時(shí)傳給回調(diào)函數(shù)痰腮。
(4)不帶有任何參數(shù)
Promise.resolve方法允許調(diào)用時(shí)不帶參數(shù),直接返回一個(gè)resolved狀態(tài)的Promise對(duì)象律罢。
所以膀值,如果希望得到一個(gè)Promise對(duì)象,比較方便的方法就是直接調(diào)用Promise.resolve方法误辑。
var p = Promise.resolve();
p.then(function () {
// ...
});
上面代碼的變量p就是一個(gè)Promise對(duì)象沧踏。
需要注意的是,立即resolve的Promise對(duì)象稀余,是在本輪“事件循環(huán)”(event loop)的結(jié)束時(shí)悦冀,而不是在下一輪“事件循環(huán)”的開(kāi)始時(shí)。
setTimeout(function () {
console.log('three');
}, 0);
Promise.resolve().then(function () {
console.log('two');
});
console.log('one');
// one
// two
// three
上面代碼中睛琳,setTimeout(fn, 0)在下一輪“事件循環(huán)”開(kāi)始時(shí)執(zhí)行盒蟆,Promise.resolve()在本輪“事件循環(huán)”結(jié)束時(shí)執(zhí)行,console.log('one')則是立即執(zhí)行师骗,因此最先輸出历等。
07、Promise.reject()
Promise.reject(reason)方法也會(huì)返回一個(gè)新的 Promise 實(shí)例辟癌,該實(shí)例的狀態(tài)為rejected寒屯。
var p = Promise.reject('出錯(cuò)了');
// 等同于
var p = new Promise((resolve, reject) => reject('出錯(cuò)了'))
p.then(null, function (s) {
console.log(s)
});
// 出錯(cuò)了
上面代碼生成一個(gè)Promise對(duì)象的實(shí)例p,狀態(tài)為rejected黍少,回調(diào)函數(shù)會(huì)立即執(zhí)行寡夹。
注意,Promise.reject()方法的參數(shù)厂置,會(huì)原封不動(dòng)地作為reject的理由菩掏,變成后續(xù)方法的參數(shù)。這一點(diǎn)與Promise.resolve方法不一致昵济。
const thenable = {
then(resolve, reject) {
reject('出錯(cuò)了');
}
};
Promise.reject(thenable)
.catch(e => {
console.log(e === thenable)
})
// true
上面代碼中智绸,Promise.reject方法的參數(shù)是一個(gè)thenable對(duì)象,執(zhí)行以后访忿,后面catch方法的參數(shù)不是reject拋出的“出錯(cuò)了”這個(gè)字符串瞧栗,而是thenable對(duì)象
08、兩個(gè)有用的附加方法
ES6的Promise API提供的方法不是很多海铆,有些有用的方法可以自己部署迹恐。下面介紹如何部署兩個(gè)不在ES6之中、但很有用的方法卧斟。
--done()
Promise對(duì)象的回調(diào)鏈殴边,不管以then方法或catch方法結(jié)尾通熄,要是最后一個(gè)方法拋出錯(cuò)誤,都有可能無(wú)法捕捉到(因?yàn)镻romise內(nèi)部的錯(cuò)誤不會(huì)冒泡到全局)找都。因此,我們可以提供一個(gè)done方法廊酣,總是處于回調(diào)鏈的尾端能耻,保證拋出任何可能出現(xiàn)的錯(cuò)誤
asyncFunc()
.then(f1)
.catch(r1)
.then(f2)
.done();
它的實(shí)現(xiàn)代碼相當(dāng)簡(jiǎn)單。
Promise.prototype.done = function (onFulfilled, onRejected) {
this.then(onFulfilled, onRejected)
.catch(function (reason) {
// 拋出一個(gè)全局錯(cuò)誤
setTimeout(() => { throw reason }, 0);
});
};
從上面代碼可見(jiàn)亡驰,done方法的使用晓猛,可以像then方法那樣用,提供fulfilled和rejected狀態(tài)的回調(diào)函數(shù)凡辱,也可以不提供任何參數(shù)戒职。但不管怎樣,done都會(huì)捕捉到任何可能出現(xiàn)的錯(cuò)誤透乾,并向全局拋出洪燥。
--finally()
finally方法用于指定不管Promise對(duì)象最后狀態(tài)如何,都會(huì)執(zhí)行的操作乳乌。它與done方法的最大區(qū)別捧韵,它接受一個(gè)普通的回調(diào)函數(shù)作為參數(shù),該函數(shù)不管怎樣都必須執(zhí)行汉操。
下面是一個(gè)例子再来,服務(wù)器使用Promise處理請(qǐng)求,然后使用finally方法關(guān)掉服務(wù)器磷瘤。
server.listen(8080)
.then(function () {
// run test
})
.finally(server.stop);
它的實(shí)現(xiàn)也很簡(jiǎn)單芒篷。
Promise.prototype.finally = function (callback) {
let P = this.constructor;
return this.then(
value => P.resolve(callback()).then(() => value),
reason => P.resolve(callback()).then(() => { throw reason })
);
};
上面代碼中,不管前面的Promise是fulfilled還是rejected采缚,都會(huì)執(zhí)行回調(diào)函數(shù)callback针炉。
09、應(yīng)用
加載圖片
我們可以將圖片的加載寫(xiě)成一個(gè)Promise仰担,一旦加載完成糊识,Promise的狀態(tài)就發(fā)生變化
const preloadImage = function (path) {
return new Promise(function (resolve, reject) {
var image = new Image();
image.onload = resolve;
image.onerror = reject;
image.src = path;
});
};
Generator函數(shù)與Promise的結(jié)合
使用Generator函數(shù)管理流程,遇到異步操作的時(shí)候摔蓝,通常返回一個(gè)Promise對(duì)象赂苗。
function getFoo () {
return new Promise(function (resolve, reject){
resolve('foo');
});
}
var g = function* () {
try {
var foo = yield getFoo();
console.log(foo);
} catch (e) {
console.log(e);
}
};
function run (generator) {
var it = generator();
function go(result) {
if (result.done) return result.value;
return result.value.then(function (value) {
return go(it.next(value));
}, function (error) {
return go(it.throw(error));
});
}
go(it.next());
}
run(g);
上面代碼的Generator函數(shù)g之中,有一個(gè)異步操作getFoo贮尉,它返回的就是一個(gè)Promise對(duì)象拌滋。函數(shù)run用來(lái)處理這個(gè)Promise對(duì)象,并調(diào)用下一個(gè)next方法猜谚。
10败砂、Promise.try()
實(shí)際開(kāi)發(fā)中赌渣,經(jīng)常遇到一種情況:不知道或者不想?yún)^(qū)分,函數(shù)f是同步函數(shù)還是異步操作昌犹,但是想用 Promise 來(lái)處理它坚芜。因?yàn)檫@樣就可以不管f是否包含異步操作,都用then方法指定下一步流程斜姥,用catch方法處理f拋出的錯(cuò)誤鸿竖。一般就會(huì)采用下面的寫(xiě)法。
Promise.resolve().then(f)
上面的寫(xiě)法有一個(gè)缺點(diǎn)铸敏,就是如果f是同步函數(shù)缚忧,那么它會(huì)在本輪事件循環(huán)的末尾執(zhí)行。
const f = () => console.log('now');
Promise.resolve().then(f);
console.log('next');
// next
// now
上面代碼中杈笔,函數(shù)f是同步的闪水,但是用 Promise 包裝了以后,就變成異步執(zhí)行了蒙具。
那么有沒(méi)有一種方法球榆,讓同步函數(shù)同步執(zhí)行,異步函數(shù)異步執(zhí)行店量,并且讓它們具有統(tǒng)一的 API 呢芜果?回答是可以的,并且還有兩種寫(xiě)法融师。第一種寫(xiě)法是用async函數(shù)來(lái)寫(xiě)
const f = () => console.log('now');
(async () => f())();
console.log('next');
// now
// next
上面代碼中右钾,第二行是一個(gè)立即執(zhí)行的匿名函數(shù),會(huì)立即執(zhí)行里面的async函數(shù)旱爆,因此如果f是同步的舀射,就會(huì)得到同步的結(jié)果;如果f是異步的怀伦,就可以用then指定下一步脆烟,就像下面的寫(xiě)法。
(async () => f())()
.then(...)
需要注意的是房待,async () => f()會(huì)吃掉f()拋出的錯(cuò)誤邢羔。所以,如果想捕獲錯(cuò)誤桑孩,要使用promise.catch方法拜鹤。
(async () => f())()
.then(...)
.catch(...)
第二種寫(xiě)法是使用new Promise()。
const f = () => console.log('now');
(
() => new Promise(
resolve => resolve(f())
)
)();
console.log('next');
// now
// next
上面代碼也是使用立即執(zhí)行的匿名函數(shù)流椒,執(zhí)行new Promise()
敏簿。這種情況下,同步函數(shù)也是同步執(zhí)行的。
鑒于這是一個(gè)很常見(jiàn)的需求惯裕,所以現(xiàn)在有一個(gè)提案读宙,提供Promise.try
方法替代上面的寫(xiě)法祸穷。
const f = () => console.log('now');
Promise.try(f);
console.log('next');
// now
// next
事實(shí)上矩动,Promise.try
存在已久屋彪,Promise 庫(kù)Bluebird
、Q
和when
握玛,早就提供了這個(gè)方法猜煮。
由于Promise.try
為所有操作提供了統(tǒng)一的處理機(jī)制,所以如果想用then
方法管理流程败许,最好都用Promise.try
包裝一下。這樣有許多好處淑蔚,其中一點(diǎn)就是可以更好地管理異常市殷。
function getUsername(userId) {
return database.users.get({id: userId})
.then(function(user) {
return user.name;
});
}
上面代碼中,database.users.get()返回一個(gè) Promise 對(duì)象刹衫,如果拋出異步錯(cuò)誤醋寝,可以用catch方法捕獲,就像下面這樣寫(xiě)带迟。
database.users.get({id: userId})
.then(...)
.catch(...)
但是database.users.get()可能還會(huì)拋出同步錯(cuò)誤(比如數(shù)據(jù)庫(kù)連接錯(cuò)誤音羞,具體要看實(shí)現(xiàn)方法),這時(shí)你就不得不用try...catch去捕獲
try {
database.users.get({id: userId})
.then(...)
.catch(...)
} catch (e) {
// ...
}
上面這樣的寫(xiě)法就很笨拙了仓犬,這時(shí)就可以統(tǒng)一用promise.catch()捕獲所有同步和異步的錯(cuò)誤嗅绰。
Promise.try(database.users.get({id: userId}))
.then(...)
.catch(...)
事實(shí)上,Promise.try就是模擬try代碼塊搀继,就像promise.catch模擬的是catch代碼塊窘面。