WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Promise.race — erste Entscheidung

Promise.race(iterable) gibt ein Promise zurück, das den Erfüllungswert oder Ablehnungsgrund des zuerst verarbeiteten Ergebnisses übernimmt. Es wartet nicht auf den ersten Erfolg und 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.race(iterable)

Promise.race(iterable) ist eine statische Methode, die ein synchrones Iterable wie etwa ein Array akzeptiert. Jedes Element wird durch Promise.resolve verarbeitet: Es kann ein Promise, ein Objekt mit einer then-Methode oder ein gewöhnlicher Wert sein.

Das Ergebnis übernimmt die zuerst verarbeitete Erfüllung oder Ablehnung. Eine Ablehnung kann daher einen Erfolg überholen. Besteht die Eingabe ausschließlich aus gewöhnlichen Werten ohne aufrufbare then-Methode oder aus bereits erfüllten oder abgelehnten nativen Promises, die Promise.resolve unverändert zurückgibt, entscheidet die Iterationsreihenfolge. Promise.resolve kann jedoch ein bereits erfülltes oder abgelehntes natives Promise aus einem anderen ECMAScript-Realm in ein neues Promise einhüllen. Dessen Zustandsübernahme erfordert zusätzliche asynchrone Schritte. Daher kann ein gewöhnlicher Wert oder ein bereits erfülltes oder abgelehntes Promise aus demselben Realm gewinnen, obwohl es in der Iteration später vorkommt. Die Ergebnis-Handler laufen weiterhin asynchron.

Promise.race([]) bleibt für immer ausstehend. Ein Fehler beim Abrufen des Iterators oder während der Iteration führt zur Ablehnung des Ergebnisses. Die Methode bricht unterlegene Vorgänge nicht ab: Dafür ist ein separater Mechanismus erforderlich.

Im Beispiel bleibt pending dauerhaft ausstehend. Promise.resolve gibt die beiden anderen Promises unverändert zurück. Das abgelehnte steht vor dem erfüllten, daher lautet das Ergebnis rejected: failed. Die Zeile sync erscheint früher, weil der an then übergebene Handler nicht auf dem aktuellen Aufruf-Stack ausgeführt wird.

Beispiele

const pending = new Promise(() => {});
const result = Promise.race([
  pending,
  Promise.reject("failed"),
  Promise.resolve("ready")
]);

result.then(
  value => console.log("fulfilled: " + value),
  reason => console.log("rejected: " + reason)
);
console.log("sync");

Ergebnis

sync
rejected: failed

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