WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Ergebnisobjekte von Promise.allSettled()

`Promise.allSettled()` liefert ein Promise, das nach Abschluss aller Eingabe-Promises mit einem Array in Eingabereihenfolge erfüllt wird. An `status` erkennst du, ob du `value` oder `reason` lesen musst.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

Promise.allSettled(iterable)

// Each element of the array that the returned promise fulfills with:
// { status: "fulfilled", value: … }
// { status: "rejected", reason: … }

Promise.allSettled(iterable) ist eine statische Methode von Promise. Sie nimmt ein synchron iterierbares Objekt entgegen, etwa ein Array. Sie verarbeitet jeden Eintrag wie Promise.resolve(): Sie übernimmt den Ausgang von Thenables und behandelt einfache Werte als Erfüllungswerte. Sobald jedes Eingabe-Promise erfüllt oder abgelehnt ist, wird das zurückgegebene Promise mit einem Array erfüllt, das pro Eintrag ein Ergebnis enthält – in Iterationsreihenfolge, nicht in Abschlussreihenfolge.

Jedes Ergebnis ist ein gewöhnliches JavaScript-Objekt. Ein Objekt mit status: "fulfilled" besitzt die eigene Eigenschaft value, aber keine eigene Eigenschaft reason. Bei status: "rejected" besitzt es reason, aber kein eigenes value. Prüfe zuerst status: 0 und undefined sind gültige Erfüllungswerte. Ein Ablehnungsgrund muss kein Error sein und kann ebenfalls undefined sein.

Anders als bei Promise.all() wird eine einzelne Ablehnung im Array festgehalten und führt nicht selbst zur Ablehnung des gemeinsamen Promises. So kannst du erfolgreiche Ergebnisse unabhängiger Aufgaben behalten und Fehler separat behandeln. Ein Fehler beim Lesen des iterierbaren Objekts kann das gemeinsame Promise dennoch ablehnen, statt ein Ergebnisobjekt zu erzeugen.

Bei leerer Eingabe gibt die Methode ein bereits mit [] erfülltes Promise zurück. Ein mit .then() registrierter Callback läuft trotzdem asynchron. Bei nicht leerer Eingabe ist das gemeinsame Promise bei standardmäßigem Promise-Verhalten zum Zeitpunkt der Rückgabe noch ausstehend, auch wenn kein Eingabe-Promise mehr aussteht. Es kann bei der Rückgabe jedoch bereits erfüllt sein, wenn der einzige Eintrag ein natives Promise ist, das Promise.resolve() unverändert zurückgibt und dessen eigene then-Methode den Erfüllungs-Callback synchron aufruft.

Beispiele

{
  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}`);
      }
    }
  });
}

Ergebnis

[{"status":"fulfilled","value":"profile"},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":0}]
value: profile
reason: offline
value: 0

Das zweite Promise wird abgelehnt, bevor das erste erfüllt wird. Sein Ergebnisobjekt steht trotzdem an zweiter Stelle. Der einfache Wert `0` ergibt ein Objekt mit dem Status `"fulfilled"`.

Zugehörige Lektionen

  • JavaScript · Lektion 15 · Mittlere Stufe · Version: 3

Quellen