Promise的使用和类方法（二）

---

theme: channing-cyan

跟着coderwhy学习

1.then方法 – 接受两个参数

• then方法是Promise对象上的一个方法：它其实是放在Promise的原型上Promise.prototype.then

• then方法接受两个参数：

  • fulfilled的回调函数：当状态变成fulfilled时会回调的函数；

  • reject的回调函数：当状态变成reject时会回调的函数； ```js promise.then(res => { console.log("res1:", res) })

    promise.then(res => { console.log("res2:", res) })

    promise.then(res => { console.log("res3:", res) }) ```

    2.then方法 – 返回值

• then方法本身是有返回值的，它的返回值是一个Promise，所以我们可以进行如下的链式调用：

  • 但是then方法返回的Promise到底处于什么样的状态呢？

• Promise有三种状态，那么这个Promise处于什么状态呢？

  • 当then方法中的回调函数本身在执行的时候，那么它处于pending状态；
  • 当then方法中的回调函数返回一个结果时，那么它处于fulfilled状态，并且会将结果作为resolve的参数；
    • 情况一：返回一个普通的值；
    • 情况二：返回一个Promise；
    • 情况三：返回一个thenable值；

  • 当then方法抛出一个异常时，那么它处于reject状态； ```js // 1> 如果我们返回的是一个普通值(数值/字符串/普通对象/undefined), 那么这个普通的值被作为一个新的Promise的resolve值 // promise.then(res => { // return "aaaaaa" // }).then(res => { // console.log("res:", res) // return "bbbbbb" // })

    // 2> 如果我们返回的是一个Promise // promise.then(res => { // return new Promise((resolve, reject) => { // setTimeout(() => { // resolve(111111) // }, 3000) // }) // }).then(res => { // console.log("res:", res) // })

    // 3> 如果返回的是一个对象, 并且该对象实现了thenable promise.then(res => { return { then: function(resolve, reject) { resolve(222222) } } }).then(res => { console.log("res:", res) }) ```

  3.catch方法 – 多次调用

• catch方法也是Promise对象上的一个方法：它也是放在Promise的原型上的Promise.prototype.catch

• 一个Promise的catch方法是可以被多次调用的：

  • 每次调用我们都可以传入对应的reject回调；

  • 当Promise的状态变成reject的时候，这些回调函数都会被执行； ```js promise.catch(err => { console.log("err:", err) })

    promise.catch(err => { console.log("err:", err) }) ```

  4.catch方法 – 返回值

• 事实上catch方法也是会返回一个Promise对象的，所以catch方法后面我们可以继续调用then方法或者catch方法：

  • 下面的代码，后续是catch中的err2打印，还是then中的res打印呢？
  • 答案是res打印，这是因为catch传入的回调在执行完后，默认状态依然会是fulfilled的； promise.catch(err => { console.log("err1:", err) }).then(res => { console.log("res2:", res) }).catch(err => { console.log("err result:", err) })
    • n那么如果我们希望后续继续执行catch，那么需要抛出一个异常： promise.catch(err => { console.log("err1:", err) throw new Erroe('error message') }).then(res => { console.log("res:", res) }).catch(err => { console.log("err2:", err) })

  5.finally方法

• finally是在ES9(ES2018)中新增的一个特性：表示无论Promise对象无论变成fulfilled还是reject状态，最终都会被执行的代码。

• finally方法是不接收参数的，因为无论前面是fulfilled状态，还是reject状态，它都会执行。

```js const promise = new Promise((resolve, reject) => { // resolve("resolve message") reject("rejcect message") })

promise.then(res => { console.log('res', res) }).catch(err => { console.log('err:', err) }).finally(() => { console.log('finally code execute') }) ```

6.resolve方法

• then、catch、finally方法都属于Promise的实例方法，都是存放在Promise的prototype上的。
  • 下面我们再来学习一下Promise的类方法。
• 有时候我们已经有一个现成的内容了，希望将其转成Promise来使用，这个时候我们可以使用 Promise.resolve 方法来完成。

• Promise.resolve的用法相当于new Promise，并且执行resolve操作： js const promise = Promise.resolve({name: 'mint'}) // 相当于 const promise2 = new Promise((resolve, reject) => { resolve({name: 'mint'}) })

• resolve参数的形态：

  • 情况一：参数是一个普通的值或者对象
  • 情况二：参数本身是Promise
  • 情况三：参数是一个thenable

7.reject方法

• reject方法类似于resolve方法，只是会将Promise对象的状态设置为reject状态。

• Promise.reject的用法相当于new Promise，只是会调用reject： js const promise = Promise.reject({name: 'mint'}) // 相当于 const promise2 = new Promise((resolve, reject) => { resolve({name: 'mint'}) })

• Promise.reject传入的参数无论是什么形态，都会直接作为reject状态的参数传递到catch的。

8.all方法

• 另外一个类方法是Promise.all：
  • 它的作用是将多个Promise包裹在一起形成一个新的Promise；
  • 新的Promise状态由包裹的所有Promise共同决定：
    • 当所有的Promise状态变成fulfilled状态时，新的Promise状态为fulfilled，并且会将所有Promise的返回值组成一个数组；
    • 当有一个Promise状态为reject时，新的Promise状态为reject，并且会将第一个reject的返回值作为参数； ```js // 创建多个Promise const p1 = new Promise((resolve, reject) => { setTimeout(() => { resolve(1111) }, 1000) })

const p2 = new Promise((resolve, reject) => { setTimeout(() => { // resolve(2222) reject(2222) }, 1000) })

const p3 = new Promise((resolve, reject) => { setTimeout(() => { resolve(3333) }, 1000) })

// 需求：所有的Promise都变成fulfilled时，再拿到结果 // 意外： 在拿到所有结果之前，有一个Promise变成了rejected，那么整个promise是rejected Promise.all([p1, p2, p3, 'aaa']).then(res => { console.log(res) }).catch(err => { console.log("err:", err) }) ```

9.allSettled方法

• all方法有一个缺陷：当有其中一个Promise变成reject状态时，新Promise就会立即变成对应的reject状态。
  • 那么对于resolved的，以及依然处于pending状态的Promise，我们是获取不到对应的结果的；

• 在ES11(ES2020)中，添加了新的API Promise.allSettled：

  • 该方法会在所有的Promise都有结果(settled)，无论是fulfilled，还是reject时，才会有最终的状态；
  • 并且这个Promise的结果一定是fulfilled的； ```js // allSettled Promise.allSettled([p1, p2, p3]).then(res => { console.log(res) }).catch(err => { console.log(err) })

  // [ // { status: 'fulfilled', value: 11111 }, // { status: 'rejected', reason: 22222 }, // { status: 'fulfilled', value: 33333 } // ] ```

• 来看一下打印的结果：
  • allSettled的结果是一个数组，数组中存放着每一个Promise的结果，并且是对应一个对象的；
  • 这个对象中包含status状态，以及对应的value值；

10.race方法

• 如果有一个Promise有了结果，我们就希望决定最终新Promise的状态，那么可以使用race方法：

  • race是竞技、竞赛的意思，表示多个Promise相互竞争，谁先有结果，那么就使用谁的结果

    ```js // 创建多个Promise const p1 = new Promise((resolve, reject) => { setTimeout(() => { resolve(11111) }, 3000); })

    const p2 = new Promise((resolve, reject) => { setTimeout(() => { reject(22222) }, 500); })

    const p3 = new Promise((resolve, reject) => { setTimeout(() => { resolve(33333) }, 1000); })

    // race: 竞技/竞赛 // 只要有一个Promise变成fulfilled状态, 那么就结束 // 意外: Promise.race([p1, p2, p3]).then(res => { console.log("res:", res) }).catch(err => { console.log("err:", err) }) // err: 22222 ```

  11.any方法

• any方法是ES12中新增的方法，和race方法是类似的：

  • any方法会等到一个fulfilled状态，才会决定新Promise的状态；
  • 如果所有的Promise都是reject的，那么也会等到所有的Promise都变成rejected状态； js Promise.any([p1, p2, p3]).then(res => { console.log("res:", res) }).catch(err => { console.log("err:", err) })
  • 如果所有的Promise都是reject的，那么会报一个AggregateError的错误。