CKTIS / JavaScript
Promise.all — un unico risultato da più promesse
Promise.all restituisce un’unica promessa per tutti gli elementi di un oggetto iterabile. Se l’iterazione si conclude senza errori e tutti gli elementi producono un valore, la promessa si realizza con un array di risultati nell’ordine di ingresso. Il primo rifiuto osservato tra le promesse in ingresso fa sì che la promessa complessiva venga rifiutata. Anche un’eccezione sollevata durante l’iterazione può causarne il rifiuto, persino se nessuna promessa in ingresso viene rifiutata. Il metodo non annulla le altre operazioni.
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.all(iterable)Promise.all(iterable) è un metodo statico che accetta un oggetto iterabile sincrono, per esempio un array. Restituisce una nuova promessa che si realizza con un array di valori quando tutti gli elementi hanno esito positivo. Sono accettati i valori normali; gli oggetti con un metodo then richiamabile vengono assimilati come promesse.
L’ordine dei risultati segue quello degli elementi in ingresso, non l’ordine di completamento delle operazioni. Un ingresso vuoto produce una promessa già realizzata con []; le funzioni di callback passate a .then() vengono comunque eseguite in modo asincrono. Anche con un ingresso non vuoto composto da valori normali o promesse realizzate, la realizzazione del risultato è asincrona.
Il primo rifiuto osservato fa rifiutare la promessa combinata con la stessa motivazione, senza attendere che le altre abbiano esito positivo. Questo non annulla il loro lavoro. Gestisci i rifiuti con .catch() oppure con try/catch attorno a await. Il metodo non invoca le funzioni fornite: per raccoglierne i risultati, invocale e passa le promesse restituite.
Nell’esempio, first si realizza dopo second, ma il risultato mantiene l’ordine di ingresso. Il numero 3 compare senza modifiche nell’array e sync viene visualizzato prima del risultato.
Esempi
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");Risultato
sync ["A","B",3]
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.