CKTIS / JavaScript
Promise.all — um resultado conjunto de várias promessas
Promise.all devolve uma única promessa para todos os elementos de um objeto iterável. Se a iteração terminar sem erros e todos os elementos produzirem um valor, a promessa é cumprida com um array de resultados pela ordem de entrada. A primeira rejeição observada entre as promessas de entrada leva à rejeição da promessa conjunta. Uma exceção lançada durante a iteração também pode causar a sua rejeição, mesmo que nenhuma promessa de entrada seja rejeitada. O método não 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.all(iterable)Promise.all(iterable) é um método estático que aceita um objeto iterável síncrono, como um array. Devolve uma nova promessa que é cumprida com um array de valores quando todos os elementos são concluídos com sucesso. São aceites valores simples; objetos com um método then invocável são assimilados como promessas.
A ordem dos resultados corresponde à ordem de entrada, não à ordem de conclusão das operações. Uma entrada vazia produz uma promessa já cumprida com []; as funções de retorno passadas a .then() continuam a ser executadas de forma assíncrona. Numa entrada não vazia composta por valores simples ou promessas cumpridas, o cumprimento do resultado também é assíncrono.
A primeira rejeição observada rejeita a promessa conjunta com o mesmo motivo, sem esperar que as restantes sejam cumpridas. Isto não cancela o trabalho delas. Trata as rejeições com .catch() ou com try/catch em torno de await. O método não invoca as funções fornecidas: para recolher os resultados, invoca-as e passa as promessas devolvidas.
No exemplo, first é cumprida depois de second, mas o resultado mantém a ordem de entrada. O número 3 aparece inalterado no array e sync é apresentado antes do resultado.
Exemplos
const first = Promise.resolve().then(() => "A");
const second = Promise.resolve("B");
Promise.all([first, second, 3]).then((values) => {
console.log(JSON.stringify(values));
});
console.log("sync");Resultado
sync ["A","B",3]
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.