在 JavaScript 的异步编程中，Promise 成为了一种非常有用的工具，它是一种用于处理异步操作的容器对象。而随着 ECMAScript 的不断更新，Promise 也在不断地发展变化。
在 ECMAScript 11（ES11）中，新增了一个非常有用的 Promise 方法 - Promise.any()。该方法可以让开发者更加简便地实现异步操作的处理，下面我们来详细了解一下该方法的相关内容。
什么是 Promise.any() 方法
Promise.any() 方法是 ES11 中新增的一个 Promise 静态方法，用于将多个 Promise 对象合并成一个新的 Promise 对象。该新的 Promise 对象只要其中任意一个原Promise对象成功（即改变状态，从 pending 变为 fulfilled 或其他的 fulfilled 状态）,就会回调执行成功状态函数（一个回调函数的集合，其中会传入一个被指定原Promise对象“成功”的的结果值），只有当所有原Promise对象都失败（即全部变为 rejected 状态）时，才会回调执行失败状态函数。
在实际应用中，Promise.any() 方法的作用非常广泛，例如：
- 用于一次性合并多个异步请求的响应数据，只有其一请求成功就可以返回数据
- 用于异步执行多个操作，只有其中一个操作执行成功就可以下一步操作
- 用于处理多个异步操作，只需等其中一个操作完成即可执行下一步
Promise.any() 方法的语法
Promise.any() 方法的定义语法如下：
Promise.any(iterable);
其中 iterable 表示一个可迭代的对象，其中存放多个 Promise 对象。通过 Promise.any() 方法可以将所有的 Promise 对象打包成一个新的 Promise 对象，该 Promise 对象只有其中一个 Promise 对象的状态被更改为 fulfilled 状态时，就会回调执行成功状态函数，只有所有 Promise 对象的状态都被更改为 rejected 状态时，才会回调执行失败状态函数。
Promise.any() 方法的参数
Promise.any() 方法只有一个参数，即一个可迭代的参数 iterable。其中，iterable 可以是任何可迭代的对象，包括数组、字符串、Set 等。
iterable 中的每个元素都必须是 Promise 对象，否则该方法会抛出错误。
Promise.any() 方法的返回值
Promise.any() 方法返回一个新的 Promise 对象，该 Promise 对象只有其中一个 Promise 对象的状态更改为 fulfilled 状态时，就会执行成功状态函数，只有所有 Promise 对象的状态都更改为 rejected 状态时，才会执行失败状态函数。
该 Promise 对象的回调函数参数是一个数组，其中包含了其中任意一个“成功”原Promise对象 的结果。
Promise.any() 方法的示例代码
下面我们通过一些示例代码来更好地理解 Promise.any() 方法的使用。
-- -------------------- ---- ------- ----- -- - --------------------- ---- ----- -- - ------------------- ----- -- - ------------------- ---------------- --- ----------------- -- - ------------------- ---------------- -- - --------------------- --- -- -- - --- -- --------展开代码
上面的代码中，我们同时创建了三个 Promise 对象 p1、p2 和 p3。其中 p1 是一个 rejected 对象，而 p2 和 p3 是 resolved 对象。
我们将这三个 Promise 对象通过 Promise.any() 方法传递参数 iterable，然后通过 then() 方法处理返回值 value，以及 catch() 方法处理错误 error。
该示例运行的结果为 2，这是因为 p2 是第一个成功的 Promise 对象，其余两个 p1 和 p3 都失败了。
再看下面这个例子，因为它们就只有一个成功的，但是代码结构是让大家更好理解的。
-- -------------------- ---- ------- ----- ----- - ---- -- - ------ --- ----------------- -- ------------------- ----- -- ----- -- - ----- -- -- - ----- ----------- ----- --- ------------ ---- -- ----- -- - ----- -- -- - ----- ----------- ------ -- -- ----- -- - ----- -- -- - ----- ----------- ------ -- -- ------------------ ----- ------------------- -- - ------------------- ---------------- -- - --------------------- --- -- -- -展开代码
上述代码中，我们使用 sleep() 方法模拟了三个异步操作的时间，然后使用 async 函数创建了三个 Promise 对象 p1，p2 和 p3。在 p1 中，我们故意让其抛出一个错误，以测试 Promise.any() 方法对错误处理的准确性。最后，我们将这三个 Promise 对象通过 Promise.any() 方法传入，然后分别通过 then() 方法处理返回值 value 和 catch() 方法处理错误 error。
该示例运行结果依然是 2，这是因为只有 p2 成功，而 p1 和 p3 都失败了。
通过上述示例代码，我们可以非常直观地了解到 Promise.any() 方法是如何工作的，它为我们的异步编程带来了更多的便利性，更加高效地处理异步任务。
结语
通过本文的介绍，我们详细了解了 ES11 新特性中的 Promise.any() 方法的相关内容，该方法可以将多个 Promise 对象打包成一个新的 Promise 对象，该新的 Promise 对象只要其中一个原 Promise 对象成功就会回调执行成功状态函数，只有所有原 Promise 对象都失败时，才会回调执行失败状态函数。
因为 Promise.any() 方法在实际应用中的意义非常大，使用起来也非常方便，我们在编写异步任务的时候可以优先考虑使用该方法以提高编程效率。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6794a9b7504e4ea9bd944b29
