CKTIS / JavaScript
Promise.any — el primer resultado satisfactorio
Promise.any acepta un objeto iterable y devuelve una promesa que se cumple con el valor del primer cumplimiento que observa. Los rechazos de las entradas no ponen fin a la espera, salvo que se rechacen todas; en ese caso, el resultado se rechaza con AggregateError.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
Promise.any(iterable)Promise.any(iterable) es un método estático de Promise, introducido en ECMAScript 2021 (ES12). Acepta un objeto iterable síncrono, como un array de promesas, valores simples u objetos con un método then (thenables). Los valores se convierten mediante Promise.resolve; no pases funciones esperando que el método las invoque.
La promesa devuelta adopta el valor del primer cumplimiento que observa Promise.any, que no tiene por qué ser el que se produjo antes. Si pasas dos promesas ordinarias ya cumplidas y el método nativo Promise.resolve devuelve ambas sin cambios, gana la primera en el orden de iteración, aunque se haya cumplido después de la segunda. El método nativo Promise.resolve devuelve una promesa sin cambios si el valor de su propiedad constructor es idéntico al valor de this en la llamada. No comprueba de qué entorno de ejecución (realm) procede la promesa. Si la primera promesa procede de otro realm y conserva su constructor predeterminado, el método local Promise.resolve la envuelve en una nueva promesa. Esto retrasa la reacción a su cumplimiento, por lo que la segunda puede ganar si se devuelve sin cambios. En cambio, si la propiedad constructor de la primera promesa tiene como valor el Promise local, el método local Promise.resolve la devuelve sin cambios pese a su procedencia. En Promise.race, el rechazo de una entrada puede determinar el resultado si el método lo observa antes que cualquier otro cumplimiento o rechazo. En Promise.any, los rechazos de las entradas solo hacen que el resultado se rechace con AggregateError cuando se han rechazado todas, incluso si solo hay una entrada y esta se rechaza. El método no cancela las demás operaciones cuando se produce un éxito.
Si se rechazan todas las entradas, el resultado se rechaza con AggregateError. Su array errors contiene los motivos en el orden de entrada, no en el orden de los rechazos. Promise.any([]) devuelve una promesa ya rechazada con un array errors vacío; los controladores siguen ejecutándose de forma asíncrona. Un error al leer el iterador también puede rechazar el resultado, sin AggregateError.
Usa este método cuando baste con un resultado satisfactorio. Gestiona el caso en que no haya ningún éxito con try/catch alrededor de await o con .catch(). La especificación del lenguaje no confirma la compatibilidad con un navegador concreto: comprueba el entorno de destino, por ejemplo con typeof Promise.any === "function". Que un repositorio incluya Node 24 no demuestra que haya compatibilidad con navegadores.
Ejemplos
async function main() {
const value = await Promise.any([
Promise.reject("offline"),
Promise.resolve("ready")
]);
console.log(value);
try {
await Promise.any([
Promise.reject("first"),
Promise.reject("second")
]);
} catch (error) {
console.log(error instanceof AggregateError);
console.log(JSON.stringify(error.errors));
}
}
main().catch(console.error);Resultado
ready true ["first","second"]
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.