Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes