es6 promise用于異步編程。Promise是異步編程的一種解決方案,比傳統(tǒng)的解決方案“回調(diào)函數(shù)和事件”更合理和更強(qiáng)大。Promise由社區(qū)最早提出和實(shí)現(xiàn),ES6將其寫進(jìn)了語(yǔ)言標(biāo)準(zhǔn),統(tǒng)一了用法,原生提供了Promise對(duì)象。從語(yǔ)法上說(shuō),Promise是一個(gè)對(duì)象,從它可以獲取異步操作的消息。Promise提供統(tǒng)一的API,各種異步操作都可以用同樣的方法進(jìn)行處理。
前端(vue)入門到精通課程:進(jìn)入學(xué)習(xí)
Apipost = Postman + Swagger + Mock + Jmeter 超好用的API調(diào)試工具:點(diǎn)擊使用
本教程操作環(huán)境:windows7系統(tǒng)、ECMAScript 6版、Dell G3電腦。
Promise的含義
Promise是異步編程的一種解決方案,比傳統(tǒng)的解決方案——回調(diào)函數(shù)和事件——更合理和更強(qiáng)大。它由社區(qū)最早提出和實(shí)現(xiàn),ES6將其寫進(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)行中)、Resolved
(已完成,又稱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)?code>Resolved和從Pending
變?yōu)?code>Rejected。只要這兩種情況發(fā)生,狀態(tài)就凝固了,不會(huì)再變了,會(huì)一直保持這個(gè)結(jié)果。就算改變已經(jīng)發(fā)生了,你再對(duì)Promise
對(duì)象添加回調(diào)函數(shù),也會(huì)立即得到這個(gè)結(jié)果。這與事件(Event)完全不同,事件的特點(diǎn)是,如果你錯(cuò)過了它,再去監(jiān)聽,是得不到結(jié)果的。
有了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è)階段(剛剛開始還是即將完成)。
如果某些事件不斷地反復(fù)發(fā)生,一般來(lái)說(shuō),使用stream模式是比部署Promise
更好的選擇。
基本用法
ES6規(guī)定,Promise對(duì)象是一個(gè)構(gòu)造函數(shù),用來(lái)生成Promise實(shí)例。
下面代碼創(chuàng)造了一個(gè)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)椤俺晒Α保磸腜ending變?yōu)镽esolved),在異步操作成功時(shí)調(diào)用,并將異步操作的結(jié)果,作為參數(shù)傳遞出去;reject
函數(shù)的作用是,將Promise對(duì)象的狀態(tài)從“未完成”變?yōu)椤笆 保磸腜ending變?yōu)镽ejected),在異步操作失敗時(shí)調(diào)用,并將異步操作報(bào)出的錯(cuò)誤,作為參數(shù)傳遞出去。
Promise實(shí)例生成以后,可以用then
方法分別指定Resolved
狀態(tài)和Reject
狀態(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)镽eject時(shí)調(diào)用。其中,第二個(gè)函數(shù)是可選的,不一定要提供。這兩個(gè)函數(shù)都接受Promise對(duì)象傳出的值作為參數(shù)。
下面是一個(gè)Promise對(duì)象的簡(jiǎn)單例子。
function timeout(ms) { return new Promise((resolve, reject) => { setTimeout(resolve, ms, 'done'); }); } timeout(100).then((value) => { console.log(value); });
上面代碼中,timeout
方法返回一個(gè)Promise實(shí)例,表示一段時(shí)間以后才會(huì)發(fā)生的結(jié)果。過了指定的時(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ù)。
如果調(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í)例,表示異步操作的結(jié)果有可能是一個(gè)值,也有可能是另一個(gè)異步操作,比如像下面這樣。
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)?code>rejected。p2
的狀態(tài)在1秒之后改變,resolve
方法返回的是p1
。此時(shí),由于p2
返回的是另一個(gè)Promise,所以后面的then
語(yǔ)句都變成針對(duì)后者(p1
)。又過了2秒,p1
變?yōu)?code>rejected,導(dǎo)致觸發(fā)catch
方法指定的回調(diào)函數(shù)。
Promise.prototype.then()
Promise實(shí)例具有then
方法,也就是說(shuō),then
方法是定義在原型對(duì)象Promise.prototype上的。它的作用是為Promise實(shí)例添加狀態(tài)改變時(shí)的回調(diào)函數(shù)。前面說(shuō)過,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)綄懛ǎ?code>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)降?code>then,可以指定一組按照次序調(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)用。
getJSON("/post/1.json").then(function(post) { return getJSON(post.commentURL); }).then(function funcA(comments) { console.log("Resolved: ", comments); }, function funcB(err){ console.log("Rejected: ", err); });
上面代碼中,第一個(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ù),上面的代碼可以寫得更簡(jiǎn)潔。
getJSON("/post/1.json").then( post => getJSON(post.commentURL) ).then( comments => console.log("Resolved: ", comments), err => console.log("Rejected: ", err) );
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)?code>Resolved,則會(huì)調(diào)用then
方法指定的回調(diào)函數(shù);如果異步操作拋出錯(cuò)誤,狀態(tài)就會(huì)變?yōu)?code>Rejected,就會(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));
下面是一個(gè)例子。
var promise = new Promise(function(resolve, reject) { throw new Error('test'); }); promise.catch(function(error) { console.log(error); }); // Error: test
上面代碼中,promise
拋出一個(gè)錯(cuò)誤,就被catch
方法指定的回調(diào)函數(shù)捕獲。注意,上面的寫法與下面兩種寫法是等價(jià)的。
// 寫法一 var promise = new Promise(function(resolve, reject) { try { throw new Error('test'); } catch(e) { reject(e); } }); promise.catch(function(error) { console.log(error); }); // 寫法二 var promise = new Promise(function(resolve, reject) { reject(new Error('test')); }); promise.catch(function(error) { console.log(error); });
比較上面兩種寫法,可以發(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ì)被捕獲,等于沒有拋出。
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 });
上面代碼中,第二種寫法要好于第一種寫法,理由是第二種寫法可以捕獲前面then
方法執(zhí)行中的錯(cuò)誤,也更接近同步的寫法(try/catch
)。因此,建議總是使用catch
方法,而不使用then
方法的第二個(gè)參數(shù)。
跟傳統(tǒng)的try/catch
代碼塊不同的是,如果沒有使用catch
方法指定錯(cuò)誤處理的回調(diào)函數(shù),Promise對(duì)象拋出的錯(cuò)誤不會(huì)傳遞到外層代碼,即不會(huì)有任何反應(yīng)。
var someAsyncThing = function() { return new Promise(function(resolve, reject) { // 下面一行會(huì)報(bào)錯(cuò),因?yàn)閤沒有聲明 resolve(x + 2); }); }; someAsyncThing().then(function() { console.log('everything is great'); });
上面代碼中,someAsyncThing
函數(shù)產(chǎn)生的Promise對(duì)象會(huì)報(bào)錯(cuò),但是由于沒有指定catch
方法,這個(gè)錯(cuò)誤不會(huì)被捕獲,也不會(huì)傳遞到外層代碼,導(dǎo)致運(yùn)行后沒有任何輸出。注意,Chrome瀏覽器不遵守這條規(guī)定,它會(huì)拋出錯(cuò)誤“ReferenceError: x is not defined”。
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ò)誤,結(jié)果由于沒有指定使用try...catch
語(yǔ)句,就冒泡到最外層,成了未捕獲的錯(cuò)誤。因?yàn)榇藭r(shí),Promise的函數(shù)體已經(jīng)運(yùn)行結(jié)束了,所以這個(gè)錯(cuò)誤是在Promise函數(shù)體外拋出的。
Node.js有一個(gè)unhandledRejection
事件,專門監(jiān)聽未捕獲的reject
錯(cuò)誤。
process.on('unhandledRejection', function (err, p) { console.error(err.stack) });
上面代碼中,unhandledRejection
事件的監(jiān)聽函數(shù)有兩個(gè)參數(shù),第一個(gè)是錯(cuò)誤對(duì)象,第二個(gè)是報(bào)錯(cuò)的Promise實(shí)例,它可以用來(lái)了解發(fā)生錯(cuò)誤的環(huán)境信息。。
需要注意的是,catch
方法返回的還是一個(gè)Promise對(duì)象,因此后面還可以接著調(diào)用then
方法。
var someAsyncThing = function() { return new Promise(function(resolve, reject) { // 下面一行會(huì)報(bào)錯(cuò),因?yàn)閤沒有聲明 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ù)。如果沒有報(bào)錯(cuò),則會(huì)跳過catch
方法。
Promise.resolve() .catch(function(error) { console.log('oh no', error); }) .then(function() { console.log('carry on'); }); // carry on
上面的代碼因?yàn)闆]有報(bào)錯(cuò),跳過了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)閤沒有聲明 resolve(x + 2); }); }; someAsyncThing().then(function() { return someOtherAsyncThing(); }).catch(function(error) { console.log('oh no', error); // 下面一行會(huì)報(bào)錯(cuò),因?yàn)閥沒有聲明 y + 2; }).then(function() { console.log('carry on'); }); // oh no [ReferenceError: x is not defined]
上面代碼中,catch
方法拋出一個(gè)錯(cuò)誤,因?yàn)楹竺鏇]有別的catch
方法了,導(dǎo)致這個(gè)錯(cuò)誤不會(huì)被捕獲,也不會(huì)傳遞到外層。如果改寫一下,結(jié)果就不一樣了。
someAsyncThing().then(function() { return someOtherAsyncThing(); }).catch(function(error) { console.log('oh no', error); // 下面一行會(huì)報(bào)錯(cuò),因?yàn)閥沒有聲明 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ò)誤。
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對(duì)象的實(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è)具體的例子。
// 生成一個(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)?code>rejected,才會(huì)調(diào)用Promise.all
方法后面的回調(diào)函數(shù)。
下面是另一個(gè)例子。
const databasePromise = connectDatabase(); const booksPromise = databaseProimse .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ù)。
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)沒有獲得結(jié)果,就將Promise的狀態(tài)變?yōu)?code>reject,否則變?yōu)?code>resolve。
var 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)?code>rejected,從而觸發(fā)catch
方法指定的回調(diào)函數(shù)。
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à)于下面的寫法。
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)?code>resolved,從而立即執(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
不屬于異步操作(判斷方法是它不是具有then方法的對(duì)象),返回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)”的開始時(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)”開始時(shí)執(zhí)行,Promise.resolve()
在本輪“事件循環(huán)”結(jié)束時(shí)執(zhí)行,console.log(’one‘)
則是立即執(zhí)行,因此最先輸出。
Promise.reject()
Promise.reject(reason)
方法也會(huì)返回一個(gè)新的Promise實(shí)例,該實(shí)例的狀態(tài)為rejected
。它的參數(shù)用法與Promise.resolve
方法完全一致。
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í)行。
兩個(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); }); };
從上面代碼可見,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(0) .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
。
應(yīng)用
加載圖片
我們可以將圖片的加載寫成一個(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
方法。
Promise.try()
實(shí)際開發(fā)中,經(jīng)常遇到一種情況:不知道或者不想?yún)^(qū)分,函數(shù)f
是同步函數(shù)還是異步操作,但是想用 Promise 來(lái)處理它。因?yàn)檫@樣就可以不管f
是否包含異步操作,都用then
方法指定下一步流程,用catch
方法處理f
拋出的錯(cuò)誤。一般就會(huì)采用下面的寫法。
Promise.resolve().then(f)
上面的寫法有一個(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í)行了。
那么有沒有一種方法,讓同步函數(shù)同步執(zhí)行,異步函數(shù)異步執(zhí)行,并且讓它們具有統(tǒng)一的 API 呢?回答是可以的,并且還有兩種寫法。第一種寫法是用async
函數(shù)來(lái)寫。
const f = () => console.log('now'); (async () => f())(); console.log('next'); // now // next
上面代碼中,第一行是一個(gè)立即執(zhí)行的匿名函數(shù),會(huì)立即執(zhí)行里面的async
函數(shù),因此如果f
是同步的,就會(huì)得到同步的結(jié)果;如果f
是異步的,就可以用then
指定下一步,就像下面的寫法。
(async () => f())() .then(...)
需要注意的是,async () => f()
會(huì)吃掉f()
拋出的錯(cuò)誤。所以,如果想捕獲錯(cuò)誤,要使用promise.catch
方法。
(async () => f())() .then(...) .catch(...)
第二種寫法是使用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è)很常見的需求,所以現(xiàn)在有一個(gè)提案,提供Promise.try
方法替代上面的寫法。
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
方法捕獲,就像下面這樣寫。
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) { // ... }
上面這樣的寫法就很笨拙了,這時(shí)就可以統(tǒng)一用promise.catch()
捕獲所有同步和異步的錯(cuò)誤。
Promise.try(database.users.get({id: userId})) .then(...) .catch(...)
事實(shí)上,Promise.try
就是模擬try
代碼塊,就像promise.catch
模擬的是catch
代碼塊。
【推薦學(xué)習(xí):javascript視頻教程】