1、介绍
Promise可以理解为是一个容器,保存着一个未来才会结束的事件的结果,是JS异步的一种实现方案
Promise有三种状态:pending(进行中)、fulfilled(已成功)和rejected(已失败)
特点:
1.对象的状态不受外界影响,只有异步操作的结果可以决定当前的状态
2.状态不可逆
缺点:
1.立即执行,无法取消
2.如果不设置回调函数,内部抛错不会反应到外部
3.pending状态无法得知进展到哪一阶段
2、用法
Promise构造函数接受一个函数作为参数,该函数接受resolve和reject函数作为参数
reject函数的参数通常是Error对象的实例,来抛出错误
resolve和reject并不会终结执行,其后代码还会正常执行,一般来说调用resolve或reject后,Promise的使命就已经完成,后续操作应放在then中,所以一般在它们前面加上return
const p = new Promise((resolve, reject) => {
if (true) {
return resolve(value)
} else {
return reject(error)
}
})
resolve函数的参数还可以是另一个Promise实例
const p1 = new Promise((resolve, reject) => {
setTimeout(() => reject(new Error('fail')), 3000)
})
const p2 = new Promise((resolve, reject) => {
setTimeout(() => resolve(p1), 1000)
})
p2.then(res => console.log(res))
.catch(err => console.log(err))
// Error: fail
p1的状态决定p2的状态,p2自身状态无效,p1 pending阶段,p2等待p1的状态改变后执行
3、Api
1.Promise.prototype.then()
Promise实例生成后,可使用then方法分别指定resolved和rejected状态的回调函数
then方法返回的是一个新的Promise实例,因此可以采用链式写法
p.then((value) => {
// success
}, (error) => {
// failure
}).then(...)
2.Promise.prototype.catch()
catch方法其实是then(null, rejection)或then(undefined, rejection)的别名,用于指定发生错误时的回调函数
Promise的错误具有“冒泡”性质,会一直向后传递,直到捕获
Promise会“吃掉错误”:如果没有使用catch方法指定错误处理的回调函数,Promise里的错误不会传递到外层
浏览器执行到这一行时,会打印该错误,但不会退出进程终止脚本
new Promise((resolve, reject) => {
resolve(x)
}).then(() => console.log('everything is great'))
setTimeout(() => { console.log(123) }, 2000)
// Uncaught (in promise) ReferenceError: x is not defined
// 123正常输出
3.Promise.prototype.finally()
不管Promise最后状态如何都会执行
4.Promise.all()
接受一组Promise实例作为参数,包装成一个新的Promise实例
const p = Promise.all([p1, p2, p3])
接受一个数组(或者返回的每个成员都是Promise实例的Iterator接口)作为参数
如果数组中不是Promise实例,会先调用Promise.resolve方法,将其转为Promise实例
状态由全部Promise决定:
1.p1、p2、p3的状态都变成fulfilled,p的状态才会变成fulfilled,此时p1、p2、p3的返回值组成一个数组,传递给p的回调函数
2.只要p1、p2、p3之中有一个被rejected,p的状态就变成rejected,此时第一个被reject的实例的返回值,会传递给p的回调函数
Promise.all()的异常处理:任何一个Promise被rejected,都会导致其它正常返回的数据也无法使用
解决思路:
1.给参数中的每个Promise实例定义catch方法,不触发all的catch
因为catch执行完后,也会变成resolved,all中的参数都是resolved,因此走then不再走catch
2.错误请求后不进行reject,而继续resolve,之后all统一处理
5.Promise.race()
其状态由率先改变状态的Promise参数的状态决定
如:3秒内请求完成触发then,未完成则触发catch
Promise.race([
fetch('/api'),
new Promise((resolve, reject) => {
setTimeout(() => reject(new Error('request timeout')), 3000)
})
])
.then(console.log)
.catch(console.error)
6.Promise.allSettled()
只有等到所有参数实例都返回结果,包装实例才会结束,并且状态总是fulfilled,不会变成rejected
它then接收到的参数是一个数组
[
{ status: 'fulfilled', value: xx },
{ status: 'rejected', reason: xx }
]
例子
const promises = [ fetch('/api1'), fetch('/api2') ]
const results = await Promise.allSettled(promises)
// 过滤出成功的请求
const successfulPromises = results.filter(p => p.status === 'fulfilled')
// 过滤出失败的请求,并输出原因
const errors = results
.filter(p => p.status === 'rejected')
.map(p => p.reason)
当不关心异步操作的结果,只关心这些操作有没有结束时,Promise.allSettled()方法就很有用,Promise.all()方法无法做到这一点
7.Promise.any()
该方法目前是一个第三阶段的提案
只要参数实例有一个变成fulfilled,包装实例就变成fulfilled
如果所有参数实例都变成rejecte态,包装实例就会变成rejected
8.Promise.resolve()
现有对象转为Promise对象
Promise.resolve('foo')
// 等同于
new Promise(resolve => resolve('foo'))
参数的四种情况:
1.Promise实例
不做任何修改、原封不动地返回这个实例
2.thenable对象(具有then方法的对象)
将这个对象转为Promise对象,然后立即执行thenable对象的then方法
3.不是具有then方法的对象,或根本就不是对象
返回一个新的Promise对象,且状态为resolved
4.不带有任何参数
直接返回一个resolved状态的Promise对象
9.Promise.reject()
返回一个新的Promise实例,且该实例状态为rejected
const p = Promise.reject('出错了')
// 等同于
const p = new Promise((resolve, reject) => reject('出错了'))
Promise.reject()方法的参数,会原封不动地作为reject的理由,变成后续方法的参数