ECMAScript 2020：Promise.allSettled API 详解

前言

在前端开发中，异步编程是不可避免的一部分。而 Promise 是我们常用的异步编程方案之一。在 ECMAScript 2020 中，新加入了 Promise.allSettled API，可以用于在所有 Promise 完成或拒绝后返回一组 Promise 的结果，不管是完成还是拒绝。

本文将对 Promise.allSettled API 进行详细的解释，并提供一些示例代码和使用建议。

Promise.all 方法简介

在介绍 Promise.allSettled API 之前，先回顾一下 Promise.all 方法。

Promise.all 接受一个 Promise 数组作为参数，并返回一个新的 Promise 对象。这个 Promise 对象最终的状态取决于传入数组中所有 Promise 对象的状态。

当所有 Promise 都执行成功时，Promise.all 返回的 Promise 对象状态为 fulfilled，并将所有 Promise 对象的结果封装到一个数组中返回。

如果传入的 Promise 数组中有一个 Promise 被拒绝了，Promise.all 返回的 Promise 对象状态为 rejected，并将被拒绝的 Promise 对象的错误原因作为返回值，不会继续等待其他 Promise 对象的状态。

Promise.allSettled 方法详解

Promise.allSettled API 在 Promise.all 基础上进行了扩展，不论传入的 Promise 对象最终是成功还是被拒绝，它都会返回一个由所有 Promise 对象组成的数组，其中每个 Promise 对象都包含以下两个属性：

• status：Promise 对象的状态，可能的值为 "fulfilled" 或 "rejected"。
• value/reason：如果 Promise 对象的状态是 "fulfilled"，则这个属性是它的返回值；如果状态是 "rejected"，则这个属性是它的错误原因。

Promise.allSettled 的完整语法如下：

Promise.allSettled(iterable);

其中：

• iterable：一个可迭代的、有序的、值为 Promise 的对象。常见的是一个数组或者一个 Set。

下面是一个简单的示例：

let p1 = Promise.resolve('fulfilled');
let p2 = Promise.reject('rejected');

Promise.allSettled([p1, p2])
  .then(results => console.log(results));

输出结果：

[
  { status: 'fulfilled', value: 'fulfilled' },
  { status: 'rejected', reason: 'rejected' }
]

Promise.allSettled 方法的使用建议

Promise.allSettled 方法可以方便地处理多个 Promise 对象的状态结果。在实际开发中，Promise.allSettled 可以用于处理需要等待多个异步操作完成后才能进行下一步操作的情况，比如：

• 批量发起请求，需要等待所有请求完成才能做后续操作。
• 需要查询多个数据源，并将结果合并后才能向用户展示完整的数据。
• 等待多个异步任务完成，再根据每个任务的状态进行对应的处理。

需要注意的是，Promise.allSettled 方法返回的 Promise 对象的状态仅在所有 Promise 对象都完成后才会确定。如果需要实时处理每个 Promise 对象的状态，可以考虑使用 Promise.race。

总结

在本文中，我们详细介绍了 ECMAScript 2020 中新增的 Promise.allSettled API。Promise.allSettled API 可以方便地返回多个 Promise 对象的状态结果。

在日常开发中，Promise.allSettled 可以用于处理需要等待多个异步操作完成后才能进行下一步操作的场景。同时，需要注意 Promise.allSettled 返回的 Promise 对象状态仅在所有 Promise 对象都完成后才会确定。

希望这篇文章能够帮助你更好地使用 Promise.allSettled API。

来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/6549d8527d4982a6eb40f11b