Promise Api

591 阅读2分钟

1.Promise.prototype.then()

Promise实例具有then方法。它的作用是为Promise 实例添加状态改变时的回调函数。then方法有两个参数,第一个是成功状态下的回调函数,第二个(可选)是失败状态下的回调函数。

2.Promise.prototype.catch()

Promise的catch()方法用于指定发生错误时的回调函数。如果异步操作抛出错误,状态就会变为rejected,就会调用catch方法指定的回调函数处理错误。另外,then方法指定的回调函数如果运行中抛出错误也会被catch方法捕获。

注:虽然then方法的第二个参数也可以定义失败的回调函数,但是建议总是使用catch方法,因为catch还可以捕获到前面then方法执行中的错误。

3.Promise.prototype.finally()

finally方法用于指定不管Promise对象最后状态如何,都会执行的操作。避免了同样的语句需要在then()和catch()中各写一次。

promise
.then(result => {···})
.catch(error => {···})
.finally(() => {···});

finally方法的回调函数不接受任何参数,所以我们没办法知道前面promise的状态。

4.Promise.all()

Promise.all方法用于将多个 Promise 实例,包装成一个新的 Promise 实例。Promise.all方法接受一个数组作为参数,p1、p2、p3都是 Promise 实例.

const p = Promise.all([p1, p2, p3]);

p的状态由p1、p2、p3决定,分成两种情况。

(1)只有p1、p2、p3的状态都变成fulfilled,p的状态才会变成fulfilled,此时p1、p2、p3的返回值组成一个数组,传递给p的回调函数。

(2)只要p1、p2、p3之中有一个被rejected,p的状态就变成rejected,此时第一个被reject的实例的返回值,会传递给p的回调函数。

注意,如果作为参数的 Promise 实例,自己定义了catch方法,那么它一旦被rejected,并不会触发Promise.all()的catch方法。

5.Promise.race()

const p = Promise.race([p1, p2, p3]);

Promise.race方法同样是将多个 Promise 实例包装成一个新的 Promise 实例。只要有一个实例率先改变状态,p的状态就跟着改变。那个率先改变的 Promise 实例的返回值,就传递给p的回调函数。

6.Promise.resolve()

Promise.resolve()方法将现有对象转为 Promise 对象。

Promise.resolve('foo')
// 等价于
new Promise(resolve => resolve('foo'))`

7.Promise.reject()

Promise.reject(reason)方法也会返回一个新的 Promise 实例,该实例的状态为rejected。

const p = Promise.reject('出错了');
// 等同于
const p = new Promise((resolve, reject) => reject('出错了'))

注意,Promise.reject()方法的参数,会原封不动地作为reject的理由,变成后续方法的参数。这一点与Promise.resolve方法不一致。