Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Promise.allSettled — esiti di tutte le promise

Promise.allSettled accetta un oggetto iterabile e restituisce una promise con un array degli esiti di tutti gli elementi. Mantiene l’ordine di input e registra sia i valori delle promise mantenute sia i motivi dei rifiuti.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

Promise.allSettled(iterable)

Promise.allSettled(iterable) è un metodo statico disponibile da ECMAScript 2020, non una Web API separata. Accetta un oggetto iterabile sincrono, come un array, e ne elabora gli elementi secondo Promise.resolve. Anche i valori normali sono quindi input validi. Il supporto nel browser di destinazione va verificato separatamente; la versione di Node usata in un repository non lo dimostra.

La promise restituita si risolve con un array quando tutti gli elementi si sono conclusi, per adempimento o rifiuto. I risultati seguono l’ordine di input, non quello di completamento. Ogni risultato ha la forma { status: "fulfilled", value: ... } oppure { status: "rejected", reason: ... }. Controlla status prima di leggere value o reason.

A differenza di Promise.all, il rifiuto di un singolo elemento non rifiuta la promise aggregata. Questo non significa che il metodo non possa mai rifiutarla: un input non valido, come null, o un’eccezione durante l’iterazione può causare un rifiuto. Se l’iterazione termina senza errori ma almeno un elemento non si conclude mai, la promise aggregata resta in attesa.

Con un input vuoto, la promise restituita è già risolta con [], ma una funzione passata a .then viene comunque eseguita in modo asincrono. Il metodo non annulla le operazioni né limita la concorrenza; ne raccoglie gli esiti.

Esempi

const inputs = [Promise.resolve(10), Promise.reject("offline"), 30];

Promise.allSettled(inputs).then((results) => {
  console.log(JSON.stringify(results));
});

Risultato

[{"status":"fulfilled","value":10},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":30}]

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti