CKTIS / JavaScript
Promise.race — primeiro cumprimento ou rejeição
Promise.race(iterable) devolve uma promessa que adota o valor de cumprimento ou o motivo de rejeição do primeiro desfecho processado. Não espera pelo primeiro sucesso nem cancela as restantes operações.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
Promise.race(iterable)Promise.race(iterable) é um método estático que aceita um iterável síncrono, como um array. Cada elemento é processado através de Promise.resolve: pode ser uma promessa, um objeto com um método then ou um valor comum.
O resultado adota o primeiro cumprimento ou a primeira rejeição a ser processada. Assim, uma rejeição pode vencer um sucesso. Se todos os elementos forem valores comuns sem um método then invocável ou promessas nativas já cumpridas ou rejeitadas que Promise.resolve devolve sem alterações, a ordem de iteração determina o vencedor. No entanto, Promise.resolve pode envolver uma promessa nativa já cumprida ou rejeitada de outro ambiente ECMAScript (realm) numa nova promessa, acrescentando passos assíncronos para adotar o seu estado. Um valor comum ou uma promessa já cumprida ou rejeitada do mesmo ambiente pode assim vencer mesmo que apareça mais tarde na iteração. Os gestores do resultado continuam a ser executados de forma assíncrona.
Promise.race([]) permanece pendente para sempre. Um erro ao obter o iterador ou durante a iteração provoca a rejeição do resultado. O método não cancela as operações perdedoras: pará-las requer um mecanismo separado.
No exemplo, pending nunca deixa de estar pendente. Promise.resolve devolve as outras duas promessas sem alterações. A rejeitada surge antes da cumprida, pelo que o resultado é rejected: failed. A linha sync aparece antes porque o gestor passado a then não é executado na pilha de chamadas atual.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.