什么是Promise
Promise 是异步编程的一种解决方案。ES6中已经提供了原生Promise
对象。一个Promise
对象会处于以下几种状态(fulfilled,rejected两种状态一旦确定后不会改变):
- 待定(pending): 初始状/态,既没有被兑现,也没有被拒绝。
- 已兑现(fulfilled): 意味着操作成功完成。
- 已拒绝(rejected): 意味着操作失败。
基本用法
Promise
对象是一个构造函数,用来创建Promise
实例,它接收两个参数resolve
和reject
。
resolve
的作用是将Promise
对象的状态从pending
变为fulfilled
,在异步操作成功时调用,并将异步操作的结果,作为参数传递出去。reject
的作用是将Promise
对象的状态从pending
变为rejected
,在异步操作失败时调用,并将异步操作报出的错误,作为参数传递出去。
const promise = new Promise(function(resolve, reject) {
// ...
if (/* 异步操作成功 */){
resolve(value);
} else {
reject(error);
}
});
Promise
实例生成以后,使用then
方法分别指定fulfilled
状态和rejected
状态的回调函数。
then
接收两个参数,第一个是Promise
对象的状态变为fulfilled
时的回调函数,第二个是状态变为rejected
时的回调函数。catch
接收Promise
对象的状态变为rejected
时的回调函数。
promise.then(function (value){
// ....
},function (err){
// .... err
})
promise.then(function (value){
// ....
}).catch(function (err){
// ....
})
Promise的方法
Promise.prototype.then()
then
方法是定义在原型对象Promise.prototype
上,前面说过,它接收两个可选参数,第一个参数是fulfilled
状态的回调函数,第二个参数是rejected
状态的回调函数。
then
方法返回的是一个新的Promise
实例,方便我们采用链式写法。比如then
后面接着写then
,当第一个回调函数完成以后,会将返回结果作为参数,传入第二个回调函数。这种链式方式可以很方便的指定一组按照次序调用的回调函数。
loadData().then(function (value){
return 3
}).then(function (num){
console.log("ok", num) // 3
})
Promise.prototype.catch()
catch
方法是用于指定发生错误时的回调函数。如果异步操作抛出错误,状态就会变为rejected
,就会调用catch()
方法指定的回调函数,处理这个错误。
const promise = new Promise(function(resolve, reject) {
throw new Error('unkonw error'); // 抛出错误状态变为 -> reject
});
const promise = new Promise(function(resolve, reject) {
reject('unkonw error') // 使用reject()方法将状态变为 -> reject
});
promise.catch(function(error) {
console.log(error);
});
Promise
对象的错误会一直向后传递,直到被捕获为止。比如下面代码:catch
会捕获loadData
和两个then
里面抛出的错误。
loadData().then(function(value) {
return loadData(value);
}).then(function(users) {
}).catch(function(err) {
// 处理前面三个Promise产生的错误
});
如果我们不设置catch()
,当遇到错误时Promise
不会将错误抛出外面,也就是不会影响外部代码执行。
const promise = new Promise(function(resolve, reject) {
resolve(a) // ReferenceError: a is not defined
});
promise.then(function(value) {
console.log('value is ', value)
});
setTimeout(() => { console.log('code is run') }, 1000); // code is run
Promise.prototype.finally()
finally()
方法不管 Promise 对象最后状态如何,都会执行的操作。下面是我们使用 Promise 的一个常规结构。
promise
.then(result => {···})
.catch(error => {···})
.finally(() => {···});
Promise.all()
Promise.all()
方法可以将多个 Promise 实例包装成一个新的 Promise 实例返回。
const promise = Promise.all([p1, p2, p3]);
新promise
状态来依赖于“传入的promise
”。
- 只有当所有“传入的
promise
”状态都变成fulfilled
,它的状态才会变成fulfilled
,此时“传入的promise
”返回值组成一个数组,传递给promise
的回调函数。 - 如果“传入的
promise
”之中有一个被rejected
,新promise
的状态就会变成rejected
,此时第一个被reject
的promise
的返回值,会传递给promise
的回调函数。
const promises = [1,2,3,4].map(function (id) {
return loadData(id);
});
Promise.all(promises).then(function (users) {
// ...
}).catch(function(err){
// ...
});
Promise.race()
Promise.race()
方法同样是将多个 Promise 实例,包装成一个新的 Promise 实例。
Promise.race()
方法的参数与Promise.all()
方法一样。
const promise = Promise.race([p1, p2, p3]);
Promise.all()
和 Promise.race()
对比:
Promise.all()
,如果所有都执行成功则返回所有成功的promise
值,如果有失败则返回第一个失败的值。Promise.race()
,返回第一个执行完成的promise
值,它可能是fulfilled和rejected状态。
这两个方法的使用场景。
场景一,用户登录社交网站主页后,会同时异步请求拉取用户信息,关注列表,粉丝列表,我们需要保证所有数据请求成功再进行渲染页面,只要有一个数据不成功就会重定向页面,这里可以使用Promise.all
。
function initUserHome() {
Promise.all([
new Promise(getMe),
new Promise(getFollows),
new Promise(getFans)
])
.then(function(data){
// 显示页面
})
.catch(function(err){
// .... 重定向页面
});
};
initUserHome();
场景二,假如我们在做一个抢票软件,虽然请求了很多卖票渠道,每次只需返回第一个执行完成的Promise
,这里可以使用Promise.race
。
function getTicket() {
Promise.race([
new Promise(postASell),
new Promise(postBSell),
new Promise(postCSell)
])
.then(function(data){
// 抢票成功
})
.catch(function(err){
// .... 抢票失败,重试
});
};
getTicket();
Promise.allSettled()
使用Promise.all()
时,如果有一个Promise
失败后,其它Promise
不会停止执行。
const requests = [
fetch('/url1'),
fetch('/url2'),
fetch('/url3'),
];
try {
await Promise.all(requests);
console.log('所有请求都成功。');
} catch {
console.log('有一个请求失败,其他请求可能还没结束。');
}
有的时候,我们希望等到一组异步操作都结束了,再进行下一步操作。这时就需要使用Promise.allSettled()
,的它参数是一个数组,数组的每个成员都是一个 Promise 对象,返回一个新的 Promise 对象。它只有等到参数数组的所有 Promise 对象都发生状态变更(不管是fulfilled
还是rejected
),返回的 Promise 对象才会发生状态变更。
const requests = [
fetch('/url1'),
fetch('/url2'),
fetch('/url3'),
];
await Promise.allSettled(requests);
console.log('所有请求完成后(包括成功失败)执行');
Promise.any()
只要传入的Promise
有一个变成fulfilled
状态,新的Promise
就会变成fulfilled
状态;如果所有传入的Promise
都变成rejected
状态,新的Promise
就会变成rejected
状态。
Promise.any()
和Promise.race()
差不多,区别在于Promise.any()
不会因为某个 Promise
变成rejected
状态而结束,必须等到所有参数 Promise
变成rejected
状态才会结束。
回到Promise.race()
多渠道抢票的场景,如果我们需要保证要么有一个渠道抢票成功,要么全部渠道都失败,使用Promise.any()
就显得更合适。
function getTicket() {
Promise.any([
new Promise(postASell),
new Promise(postBSell),
new Promise(postCSell)
])
.then(function(data){
// 有一个抢票成功
})
.catch(function(err){
// .... 所有渠道都失败了
});
};
getTicket();
Promise.resolve()
Promise.resolve()
方法将现有对象转换为Promise
对象。等价于下面代码:
new Promise(resolve => resolve(1))
传入的参数不同,处理
-
参数
Promise
实例,它将不做任何修改、原封不动地返回这个实例。 -
参数
thenable
对象,它会将这个对象转为Promise
对象,然后就立即执行thenable
对象的then()
方法。let thenable = { then: function(resolve, reject) { resolve(1); } };
-
参数是普通值,返回一个新的 Promise 对象,状态为
resolved
。const promise = Promise.resolve(1); promise.then(function (value) { console.log(value) // 1 });
-
无参数,直接返回一个
resolved
状态的 Promise 对象。
Promise.reject()
Promise.reject(reason)
方法也会返回一个新的 Promise 实例,该实例的状态为rejected
。
const promise = Promise.reject('unkonw error');
// 相当于
const promise = new Promise((resolve, reject) => reject('unkonw error'))
promise.then(null, function (s) {
console.log(s)
});
// unkonw error
简单场景
异步加载图片:
function loadImageAsync(url) {
return new Promise(function(resolve, reject) {
const image = new Image();
image.onload = resolve;
image.onerror = reject;
image.src = url;
});
}
请求超时处理:
//请求
function request(){
return new Promise(function(resolve, reject){
// code ....
resolve('request ok')
})
}
function timeoutHandle(time){
return new Promise(function(resolve, reject){
setTimeout(function(){
reject('timeout');
}, time);
});
}
Promise.race([
request(),
timeoutHandle(5000)
])
.then(res=>{
console.log(res)
}).catch(err=>{
console.log(err)// timeout
})
小结
本文归纳了Promise
相关方法和一些简单用法,欢迎留言交流。