Promise.any() 是 ES11 中新增的 Promise 方法,它可以接收一个 Promise 数组作为参数,并返回一个新的 Promise 对象。当 Promise 数组中的任意一个 Promise 对象状态变为 resolved 时,该 Promise 对象就会变为 resolved 状态,并返回该 Promise 对象的值。
在 ES12 中,Promise.any() 方法进行了一些改进,它可以接收一个可迭代的对象作为参数,包括数组、Set 对象和 Map 对象等,并返回一个新的 Promise 对象。当可迭代对象中的任意一个 Promise 对象状态变为 resolved 时,该 Promise 对象就会变为 resolved 状态,并返回该 Promise 对象的值。
语法
Promise.any(iterable)
参数:
- iterable:可迭代对象,包括数组、Set 对象和 Map 对象等。
返回值:
- 返回一个新的 Promise 对象。
示例
下面是一个使用 Promise.any() 方法的示例代码:
----- -------- - - --------------------- ---- ------------------------ ---- ------------------------ --- -- --------------------- ----------- -- ------------------- ------------ -- --------------------
在上面的示例代码中,我们定义了一个包含三个 Promise 对象的数组 promises。第一个 Promise 对象被 reject,第二个和第三个 Promise 对象被 resolve。我们使用 Promise.any() 方法接收 promises 数组作为参数,并使用 then() 方法获取返回的 Promise 对象的值。由于 promises 数组中的第二个和第三个 Promise 对象被 resolve,所以 Promise.any() 方法返回的 Promise 对象的状态为 resolved,并返回第二个 Promise 对象的值 'Success 1'。
如果我们将 promises 数组中的第二个和第三个 Promise 对象都改为 reject,那么 Promise.any() 方法将会返回一个 rejected 状态的 Promise 对象,并返回一个 AggregateError 类型的错误对象,其中包含所有 Promise 对象的错误信息。
----- -------- - - --------------------- ---- --------------------- ---- --------------------- --- -- --------------------- ----------- -- ------------------- ------------ -- --------------------
输出结果:
--------------- --- -------- -------- -- ----------- -- ------------------------- --------------------------------------
应用实例
Promise.any() 方法可以用于处理多个异步操作的场景,例如在一个 Web 应用中同时请求多个 API 接口,只要其中一个请求成功,就可以将其返回的数据作为页面内容进行展示。
下面是一个使用 Promise.any() 方法处理多个异步请求的示例代码:
----- ------- - - ----------------------- ----------------------- ---------------------- -- ----- -------- - --------------- -- ------------------------ -- ------------------ --------------------- ---------- -- - -- ------ ------------------ -- ------------ -- - -- ------ ------------------- ---
在上面的示例代码中,我们定义了一个包含三个 API 接口 URL 的数组 apiUrls,然后使用 map() 方法将每个 URL 转换为一个 Promise 对象。我们使用 Promise.any() 方法接收 Promise 数组作为参数,并使用 then() 方法获取返回的 Promise 对象的值。由于 Promise 数组中的任意一个 Promise 对象被 resolve,Promise.any() 方法返回的 Promise 对象的状态为 resolved,并返回该 Promise 对象的值。我们可以在 then() 方法中处理返回的数据。如果所有 Promise 对象都被 reject,那么 Promise.any() 方法将会返回一个 rejected 状态的 Promise 对象,并返回一个 AggregateError 类型的错误对象,其中包含所有 Promise 对象的错误信息。
总结
Promise.any() 方法是 ES11 和 ES12 中新增的 Promise 方法,它可以接收一个 Promise 数组或可迭代对象作为参数,并返回一个新的 Promise 对象。当 Promise 数组或可迭代对象中的任意一个 Promise 对象状态变为 resolved 时,该 Promise 对象就会变为 resolved 状态,并返回该 Promise 对象的值。Promise.any() 方法可以用于处理多个异步操作的场景,例如在一个 Web 应用中同时请求多个 API 接口,只要其中一个请求成功,就可以将其返回的数据作为页面内容进行展示。
来源:JavaScript中文网 ,转载请注明来源 本文地址:https://www.javascriptcn.com/post/65d082feadd4f0e0ff97ac53