CKTIS / JavaScript
Promise.allSettled — resultados de todas as promessas
Promise.allSettled aceita um objeto iterável e devolve uma promessa com um array dos resultados de todos os elementos. Mantém a ordem de entrada e regista tanto os valores das promessas cumpridas como os motivos das rejeiçõ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.allSettled(iterable)Promise.allSettled(iterable) é um método estático disponível desde o ECMAScript 2020, e não uma Web API separada. Aceita um objeto iterável síncrono, como um array, e processa os seus elementos de acordo com Promise.resolve. Assim, valores simples também são entradas válidas. O suporte no navegador de destino deve ser verificado separadamente; a versão de Node usada num repositório não o comprova.
A promessa devolvida é cumprida com um array quando todos os elementos ficam resolvidos, quer por cumprimento, quer por rejeição. Os resultados seguem a ordem de entrada, não a ordem de conclusão. Cada resultado tem a forma { status: "fulfilled", value: ... } ou { status: "rejected", reason: ... }. Verifica status antes de ler value ou reason.
Ao contrário de Promise.all, a rejeição de um elemento individual não rejeita a promessa agregada. No entanto, isso não significa que o método nunca a possa rejeitar: uma entrada inválida, como null, ou uma exceção durante a iteração pode causar uma rejeição. Se a iteração terminar sem erros, mas algum elemento nunca for cumprido nem rejeitado, a promessa agregada permanece pendente.
Com uma entrada vazia, a promessa devolvida já está cumprida com [], mas uma função passada a .then continua a ser executada de forma assíncrona. O método não cancela operações nem limita a concorrência; reúne os respetivos resultados.
Exemplos
const inputs = [Promise.resolve(10), Promise.reject("offline"), 30];
Promise.allSettled(inputs).then((results) => {
console.log(JSON.stringify(results));
});Resultado
[{"status":"fulfilled","value":10},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":30}]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.