CKTIS / JavaScript
Promise.all — ein gemeinsames Ergebnis aus mehreren Promises
Promise.all gibt ein einziges Promise für alle Elemente eines iterierbaren Objekts zurück. Wenn die Iteration fehlerfrei endet und alle Elemente Werte liefern, wird das Promise mit einem Array der Ergebnisse in Eingabereihenfolge erfüllt. Die erste beobachtete Zurückweisung eines Eingabe-Promises weist das gemeinsame Promise zurück. Auch eine während der Iteration ausgelöste Ausnahme kann es zurückweisen, selbst wenn kein Eingabe-Promise zurückgewiesen wird. Die Methode bricht die übrigen Vorgänge nicht ab.
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.all(iterable)Promise.all(iterable) ist eine statische Methode, die ein synchrones iterierbares Objekt wie etwa ein Array annimmt. Sie gibt ein neues Promise zurück, das mit einem Array von Werten erfüllt wird, sobald alle Elemente erfolgreich abgeschlossen sind. Einfache Werte sind zulässig; Objekte mit einer aufrufbaren then-Methode werden wie Promises übernommen.
Die Reihenfolge der Ergebnisse entspricht der Eingabereihenfolge, nicht der Reihenfolge, in der die Vorgänge abgeschlossen werden. Eine leere Eingabe ergibt ein bereits mit [] erfülltes Promise; an .then() übergebene Callbacks werden dennoch asynchron ausgeführt. Bei einer nicht leeren Eingabe mit einfachen Werten oder erfüllten Promises erfolgt auch die Erfüllung des Ergebnisses asynchron.
Die erste beobachtete Zurückweisung weist das gemeinsame Promise mit demselben Grund zurück, ohne auf den Erfolg der übrigen zu warten. Dadurch wird deren Arbeit nicht abgebrochen. Behandle Zurückweisungen mit .catch() oder mit try/catch um await. Die Methode ruft übergebene Funktionen nicht auf: Um ihre Ergebnisse zu sammeln, rufe sie auf und übergib die zurückgegebenen Promises.
Im Beispiel wird first nach second erfüllt, aber das Ergebnis behält die Eingabereihenfolge bei. Die Zahl 3 erscheint unverändert im Array, und sync wird vor dem Ergebnis ausgegeben.
Beispiele
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");Ergebnis
sync ["A","B",3]
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.