CKTIS / JavaScript
Record dei risultati di Promise.allSettled()
`Promise.allSettled()` restituisce una promessa che, al termine di tutte le promesse in ingresso, viene soddisfatta con un array di risultati nell’ordine di ingresso. `status` indica se leggere `value` o `reason`.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
Promise.allSettled(iterable)
// Each element of the array that the returned promise fulfills with:
// { status: "fulfilled", value: … }
// { status: "rejected", reason: … }Promise.allSettled(iterable) è un metodo statico di Promise che accetta un iterabile sincrono, come un array. Tratta ogni elemento come farebbe Promise.resolve(): adotta l’esito dei thenable e usa i valori semplici come valori di adempimento. Quando ogni promessa in ingresso è stata soddisfatta o rifiutata, la promessa restituita viene soddisfatta con un array che contiene un risultato per elemento, nell’ordine di iterazione e non in quello di completamento.
Ogni record è un normale oggetto JavaScript. Con status: "fulfilled", ha una proprietà propria value, ma non una proprietà propria reason. Con status: "rejected", ha una proprietà propria reason, ma non una proprietà propria value. Controlla prima status: 0 e undefined possono essere valori di adempimento validi e il motivo del rifiuto non deve essere per forza un Error e può anche essere undefined.
A differenza di Promise.all(), un singolo rifiuto viene registrato nell’array e non comporta di per sé il rifiuto della promessa complessiva. Questo permette di conservare i risultati positivi di attività indipendenti e gestire separatamente gli insuccessi. Un errore durante la lettura dell’iterabile può comunque causare il rifiuto della promessa complessiva anziché produrre un record di risultato.
Se l’iterabile è vuoto, il metodo restituisce una promessa già soddisfatta con [], ma la funzione passata a .then() viene comunque eseguita in modo asincrono. Se l’iterabile non è vuoto, con il comportamento standard delle promesse, la promessa complessiva è ancora in attesa quando il metodo la restituisce, anche se nessuna promessa in ingresso è ancora in attesa. Può però essere già soddisfatta al momento della restituzione se l’unico elemento è una promessa nativa che Promise.resolve() restituisce invariata e il cui metodo then, definito sulla promessa stessa, chiama in modo sincrono la funzione di adempimento.
Esempi
{
let finishFirst;
const first = new Promise((resolve) => { finishFirst = resolve; });
const second = Promise.reject("offline");
const batch = Promise.allSettled([first, second, 0]);
finishFirst("profile");
batch.then((results) => {
console.log(JSON.stringify(results));
for (const result of results) {
if (result.status === "fulfilled") {
console.log(`value: ${result.value}`);
} else {
console.log(`reason: ${result.reason}`);
}
}
});
}Risultato
[{"status":"fulfilled","value":"profile"},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":0}]
value: profile
reason: offline
value: 0La seconda promessa viene rifiutata prima che la prima venga soddisfatta, ma il suo record rimane in seconda posizione. Il valore semplice `0` produce un record con stato `"fulfilled"`.
Lezioni correlate
- JavaScript · Lezione 15 · Intermedio · Versione: 3