Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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: 0

La 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

Fonti