详解 promise.all 和 promise.allSettled 的区别

最新推荐文章于 2025-05-20 14:15:35 发布

JacksonChen_

最新推荐文章于 2025-05-20 14:15:35 发布

阅读量3.7k

点赞数 25

CC 4.0 BY-SA版权

文章标签：前端 javascript 开发语言

本文链接：https://blog.csdn.net/chenyajundd/article/details/137785515

本文对比了Promise.all和Promise.allSettled在处理Promise数组时的行为，前者在任一Promise失败时立即拒绝，后者等待所有Promise完成并返回包含状态和结果的对象数组。适合理解JavaScript中处理异步操作的不同策略。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

前言

说到 Promise.all，很多人应该不陌生，那 Promise.allSettled，可能很多朋友并没有使用过，这两者有相同部分，也有不同部分，今天就带大家一起来了解一下这两个方法。

Promise.all()

Promise.all() 方法接受一个 Promise 对象的数组作为参数，并返回一个新的 Promise 实例。

该实例会在所有传入的 Promise 实例都完成后才完成，而且传入的 Promise 实例中只要有一个被拒绝，则该实例就会立即被拒绝。

它的主要作用是将多个 Promise 实例组合成一个单一的 Promise 实例。

MDN官方解释：

Promise.all() - JavaScript | MDN (mozilla.org)

举例说明：

const promise1 = new Promise((resolve, reject) => {
  setTimeout(() => resolve('Promise 1 resolved'), 1000);
});

const promise2 = new Promise((resolve, reject) => {
  setTimeout(() => reject('Promise 2 rejected'), 500);
});

const promise3 = new Promise((resolve, reject) => {
  setTimeout(() => resolve('Promise 3 resolved'), 1500);
});

// 使用 Promise.all
Promise.all([promise1, promise2, promise3])
  .then(results => console.log(results))
  .catch(error => console.error(error));
// 输出: Promise 2 rejected

结果如下：

可以看到我们上面写了三个 Promise，promise1 /promise3为成功状态的promise，promise2为拒绝，所以打印结果为失败状态的 promise 。

如果三个都成功，则会输出一个数组，保存成功返回的信息。

Promise.allSettled()

Promise.allSettled() 方法也接受一个 Promise 对象的数组作为参数，并返回一个新的 Promise 实例。

该实例会在所有传入的 Promise 实例都完成(无论是 resolved 还是 rejected)后才完成。

它会将每个传入的 Promise 实例的结果收集到一个数组中，数组中每一项是一个对象，对象的 status 表示对应 Promise 实例的状态，value 表示对应 Promise 实例的值，reason 仅当 status 为 "rejected"，才存在，promsie 拒绝的原因。

MDN官方解释：

Promise.allSettled() - JavaScript | MDN (mozilla.org)

  const promise1 = new Promise((resolve, reject) => {
    setTimeout(() => resolve('Promise 1 resolved'), 1000)
  })

  const promise2 = new Promise((resolve, reject) => {
    setTimeout(() => reject('Promise 2 rejected'), 500)
  })

  const promise3 = new Promise((resolve, reject) => {
    setTimeout(() => resolve('Promise 3 resolved'), 1500)
  })

  // 使用 Promise.allSettled
  Promise.allSettled([promise1, promise2, promise3])
    .then((results) => console.log(results))
    .catch((error) => console.error(error))

同上，打印结果如下：

可以看到和 Promise.all 不同的是，返回的是一个数组对象的格式，参数意义如下：

区别

Promise.all() 在其中任何一个 Promise 被拒绝时就会被拒绝，而 Promise.allSettled() 则会在所有 Promise 实例都完成(无论成功还是失败)时才完成。
Promise.all() 返回的是一个数组,数组中的值是传入的 Promise 实例的结果值,而 Promise.allSettled() 返回的是一个数组，数组中的值是对象，每个对象表示对应的 Promise 实例的状态和结果值。
当你需要获取所有异步操作的结果时，无论是成功还是失败，应该使用 Promise.allSettled()。如果只关心所有操作都成功的情况，可以使用 Promise.all()。