掌握 ECMAScript 2021（ES12）中的 Promise.any 方法-JavaScript中文网-JavaScript教程资源分享门户

前言

Promise 是 JavaScript 中异步编程的重要手段之一，它可以帮助我们处理异步操作并避免回调地狱的出现。自 ES6 开始，Promise 就已经成为了 JavaScript 标准库的一部分。而在 ES12（ECMAScript 2021）中，新增了 Promise.any 方法，它可以帮助我们更加便捷地处理异步操作，本篇文章就来详细介绍一下 Promise.any 方法。

Promise.any 方法简介

Promise.any 方法用于处理多个 Promise 实例，只要其中任意一个 Promise 实例变为 resolved 状态，就会返回该 Promise 实例的结果。如果所有 Promise 实例都变为 rejected 状态，就会返回一个 AggregateError 实例，其中包含了所有 Promise 实例的错误信息。

Promise.any 方法的语法如下：

Promise.any(iterable);

其中，iterable 为一个可迭代对象，例如数组。

Promise.any 方法示例

下面通过一个示例来演示 Promise.any 方法的使用。

// javascriptcn.com 代码示例
const promises = [
  Promise.reject('Error 1'),
  Promise.resolve('Success 1'),
  Promise.reject('Error 2'),
  Promise.resolve('Success 2')
];

Promise.any(promises).then(result => {
  console.log(result);
}).catch(error => {
  console.error(error);
});

上述代码中，我们定义了一个包含 4 个 Promise 实例的数组 promises，其中 Promise.reject 表示 Promise 实例被拒绝，Promise.resolve 表示 Promise 实例被解决。我们调用 Promise.any 方法，传入 promises 数组作为参数，然后使用 then 方法处理 Promise 实例成功的情况，使用 catch 方法处理 Promise 实例失败的情况。

根据 Promise.any 方法的规则，只要有一个 Promise 实例被解决，就会返回该 Promise 实例的结果。因此，上述代码会输出 "Success 1"，而不会输出 "Error 1"。

Promise.any 方法注意事项

在使用 Promise.any 方法时，需要注意以下几点：

iterable 参数必须是一个可迭代对象，例如数组，否则会抛出 TypeError 异常。
如果所有 Promise 实例都变为 rejected 状态，就会返回一个 AggregateError 实例，其中包含了所有 Promise 实例的错误信息。因此，在使用 catch 方法处理 Promise 实例失败的情况时，需要注意 AggregateError 实例的处理方式。
如果 iterable 参数中包含非 Promise 实例的值，Promise.any 方法会将其转换为 Promise 实例。例如，如果 iterable 参数中包含字符串 "Hello World"，Promise.any 方法会将其转换为 Promise.resolve("Hello World")。

总结

Promise.any 方法是 ES12 中新增的一个非常实用的方法，它可以帮助我们更加便捷地处理多个 Promise 实例。在实际开发中，我们可以使用 Promise.any 方法来简化异步操作的处理，提高代码的可读性和可维护性。

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