Promise.all()

Promise.all()方法用于将多个 Promise 实例,包装成一个新的 Promise 实例。

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

上面代码中,Promise.all()方法接受一个数组作为参数,p1p2p3都是 Promise 实例,如果不是,就会先调用下面讲到的Promise.resolve方法,将参数转为 Promise 实例,再进一步处理。另外,Promise.all()方法的参数可以不是数组,但必须具有 Iterator 接口,且返回的每个成员都是 Promise 实例。

p的状态由p1p2p3决定,分成两种情况。

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

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

下面是一个具体的例子。

  1. // 生成一个Promise对象的数组
  2. const promises = [2, 3, 5, 7, 11, 13].map(function (id) {
  3. return getJSON('/post/' + id + ".json");
  4. });
  5. Promise.all(promises).then(function (posts) {
  6. // ...
  7. }).catch(function(reason){
  8. // ...
  9. });

上面代码中,promises是包含 6 个 Promise 实例的数组,只有这 6 个实例的状态都变成fulfilled,或者其中有一个变为rejected,才会调用Promise.all方法后面的回调函数。

下面是另一个例子。

  1. const databasePromise = connectDatabase();
  2. const booksPromise = databasePromise
  3. .then(findAllBooks);
  4. const userPromise = databasePromise
  5. .then(getCurrentUser);
  6. Promise.all([
  7. booksPromise,
  8. userPromise
  9. ])
  10. .then(([books, user]) => pickTopRecommendations(books, user));

上面代码中,booksPromiseuserPromise是两个异步操作,只有等到它们的结果都返回了,才会触发pickTopRecommendations这个回调函数。

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

  1. const p1 = new Promise((resolve, reject) => {
  2. resolve('hello');
  3. })
  4. .then(result => result)
  5. .catch(e => e);
  6. const p2 = new Promise((resolve, reject) => {
  7. throw new Error('报错了');
  8. })
  9. .then(result => result)
  10. .catch(e => e);
  11. Promise.all([p1, p2])
  12. .then(result => console.log(result))
  13. .catch(e => console.log(e));
  14. // ["hello", Error: 报错了]

上面代码中,p1resolvedp2首先会rejected,但是p2有自己的catch方法,该方法返回的是一个新的 Promise 实例,p2指向的实际上是这个实例。该实例执行完catch方法后,也会变成resolved,导致Promise.all()方法参数里面的两个实例都会resolved,因此会调用then方法指定的回调函数,而不会调用catch方法指定的回调函数。

如果p2没有自己的catch方法,就会调用Promise.all()catch方法。

  1. const p1 = new Promise((resolve, reject) => {
  2. resolve('hello');
  3. })
  4. .then(result => result);
  5. const p2 = new Promise((resolve, reject) => {
  6. throw new Error('报错了');
  7. })
  8. .then(result => result);
  9. Promise.all([p1, p2])
  10. .then(result => console.log(result))
  11. .catch(e => console.log(e));
  12. // Error: 报错了