WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Promise.allSettled — Ergebnisse aller Promises

Promise.allSettled akzeptiert ein iterierbares Objekt und liefert ein Promise für ein Array mit den Ergebnissen aller Elemente. Die Eingabereihenfolge bleibt erhalten; sowohl erfüllte Werte als auch Ablehnungsgründe werden festgehalten.

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

Syntax

Promise.allSettled(iterable)

Promise.allSettled(iterable) ist eine statische Methode, die es seit ECMAScript 2020 gibt, und keine eigenständige Web-API. Sie akzeptiert ein synchrones iterierbares Objekt, etwa ein Array, und verarbeitet dessen Elemente gemäß Promise.resolve. Daher sind auch einfache Werte gültige Eingaben. Die Unterstützung im Zielbrowser muss separat geprüft werden; die in einem Repository verwendete Node-Version belegt sie nicht.

Das zurückgegebene Promise wird mit einem Array erfüllt, sobald alle Elemente abgeschlossen sind, also entweder erfüllt oder abgelehnt wurden. Die Ergebnisse entsprechen der Eingabereihenfolge, nicht der Reihenfolge ihres Abschlusses. Jedes Ergebnis hat entweder die Form { status: "fulfilled", value: ... } oder { status: "rejected", reason: ... }. Prüfe status, bevor du value oder reason liest.

Anders als bei Promise.all führt die Ablehnung eines einzelnen Elements nicht zur Ablehnung des Sammel-Promises. Das bedeutet jedoch nicht, dass die Methode es niemals ablehnen kann: Ungültige Eingaben wie null oder eine Ausnahme während der Iteration können eine Ablehnung verursachen. Wenn die Iteration ohne Fehler endet, aber mindestens ein Element weder erfüllt noch abgelehnt wird, bleibt das Sammel-Promise ausstehend.

Bei einer leeren Eingabe ist das zurückgegebene Promise bereits mit [] erfüllt; eine an .then übergebene Funktion wird trotzdem asynchron ausgeführt. Die Methode bricht keine Vorgänge ab und begrenzt auch nicht die Nebenläufigkeit; sie sammelt deren Ergebnisse.

Beispiele

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

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

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen