CKTIS / JavaScript
Promise.race — primer cumplimiento o rechazo
Promise.race(iterable) devuelve una promesa que adopta el valor de cumplimiento o el motivo de rechazo del primer desenlace que se procesa. No espera al primer éxito ni cancela las demás operaciones.
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.race(iterable)Promise.race(iterable) es un método estático que acepta un iterable síncrono, como un array. Cada elemento se procesa mediante Promise.resolve: puede ser una promesa, un objeto con un método then o un valor ordinario.
El resultado adopta el primer cumplimiento o rechazo que se procesa. Por tanto, un rechazo puede imponerse a un éxito. Si todos los elementos son valores ordinarios sin un método then invocable o promesas nativas ya cumplidas o rechazadas que Promise.resolve devuelve intactas, el orden de iteración determina quién gana. Sin embargo, Promise.resolve puede envolver una promesa nativa ya cumplida o rechazada de otro entorno de ECMAScript (realm) en una promesa nueva, lo que añade pasos asíncronos para adoptar su estado. Así, un valor ordinario o una promesa ya cumplida o rechazada del mismo entorno puede ganar aunque aparezca más tarde en la iteración. Los manejadores del resultado siguen ejecutándose de forma asíncrona.
Promise.race([]) permanece pendiente para siempre. Un error al obtener el iterador o durante la iteración provoca el rechazo del resultado. El método no cancela las operaciones perdedoras: detenerlas requiere un mecanismo aparte.
En el ejemplo, pending nunca deja de estar pendiente. Promise.resolve devuelve intactas las otras dos promesas. La rechazada aparece antes que la cumplida, así que el resultado es rejected: failed. La línea sync aparece antes porque el manejador pasado a then no se ejecuta en la pila de llamadas actual.
Ejemplos
const pending = new Promise(() => {});
const result = Promise.race([
pending,
Promise.reject("failed"),
Promise.resolve("ready")
]);
result.then(
value => console.log("fulfilled: " + value),
reason => console.log("rejected: " + reason)
);
console.log("sync");Resultado
sync rejected: failed
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.