重学前端 - ES6 - Promise

188 阅读4分钟
学习资料:阮一峰ECMAScript6入门

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的理由,变成后续方法的参数