在 ES2021 中新增的 Promise.any() 方法可以解决开发者在处理多个 Promise 时需要全部都成功或其中一个失败时的情况，进一步提高了 Promise 在异步编程中的便利性和灵活性。本文将详细介绍 Promise.any() 方法的用法和实现原理，以及应该如何在项目中运用。
Promise.any() 方法的用法
Promise.any() 方法接受一个 Promise 实例数组作为参数，返回一个新的 Promise 实例，该实例在数组中的任意一个 Promise 解决(resolve)时立即解决；如果数组中没有 Promise 成功(resolve)，则返回一个拒绝(reject)状态的 Promise 实例，其中包括一个 AggregateError 类型的错误，表示所有 Promise 的拒绝(error)。
Promise.any([Promise.resolve(1), Promise.reject('Reject 1'), Promise.resolve(3)]) .then(console.log) // 1 .catch(console.error); // AggregateError: No Promise in Promise.any was resolved
当数组中存在一个或多个运行良好的 Promise 时，Promise.any() 方法将返回第一个解决的 Promise 对应的值。在上述示例中，第一个 Promise 实例成功解决，因此 Promise.any() 方法成功执行。在其他情况下，例如 Promise 实例全部被拒绝或 Promise 实例为空，将导致 Promise.any() 方法返回拒绝状态的 Promise 实例。
Promise.any() 方法的实现原理
Promise.any() 方法在内部使用了 Promise.race() 方法的概念，不同之处在于 Promise.race() 方法的成功(complete)和拒绝(complete)状态全部作为解决状态的一部分返回，而 Promise.any() 方法只关注值(Value)的成功状态。
它返回一个解决的 Promise 实例数组和一个拒绝异常实例数组，在第一个解决值被解析或 rejected，或在所有的 Promise 实例都被拒绝时，向下传递序列化的错误。
-- -------------------- ---- ------- ----------- - ------------------ - -- -------------------------- - ----- --- ------------------------ ------- -- -------- - -- ---------------- --- -- - ------ ------------------ ------------------ -------- -- --------- - ----- ------ - --- ------ --- ----------------- ------- -- - -------------------------- ------ -- - -------------------------------------- -------------- -- ------------- - ------ -------- -- - -- ------ --- --------------- - -- - ---------- ------------------------ - --- --- --- --展开代码
因此，当执行 Promise.any() 方法时，它将返回一个新的 Promise 实例，该实例在值的任一解决状态下成功，或在所有的 Promise 实例被拒绝状态下拒绝。
应用案例和指导意义
Promise.any() 方法的应用场景非常广泛，特别是在处理数据解析、图像上传等需要同时处理多个异步操作的场景中。早期，对于这种情况，开发者们通常需要手动处理多个 Promise 实例，使用 Promise.all() 方法等待它们全部成功或拒绝，这往往会导致代码可读性差和效率低下。
例如，在以下示例中，我们可以使用 Promise.any() 方法来监控图像上传操作的进行情况，并返回已经上传的图像 URL。假设上传操作的方法为 uploadImage()，它返回一个 Promise 实例：
const uploadImages = async function(imageFiles) { const promises = imageFiles.map(uploadImage); const uploadedImages = await Promise.any(promises) .catch((e) => console.error(e)); return uploadedImages; }
通过使用 Promise.any() 方法，我们可以使用更简单的代码来处理一系列 Promise 实例，这将使异常处理更加方便和高效。我们可以使用 Promise.any() 方法来优化代码，并通过减少代码量和提高可读性来增强代码质量和可维护性。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/67c424366e1fc40e36cffbc3
