WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

await-Operator — auf ein Ergebnis warten

Ein await-Ausdruck unterbricht die laufende Ausführung einer asynchronen Funktion oder eines Moduls, bis der erwartete Wert feststeht. Er liefert den Erfüllungswert eines Promise oder wirft dessen Ablehnungsgrund, ohne den gesamten Thread zu blockieren.

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

await expression

await expression wertet seinen Operanden aus und wartet über den Promise-Mechanismus auf dessen Ergebnis. Wird das Promise erfüllt, liefert der await-Ausdruck den Erfüllungswert; bei einer Ablehnung wird deren Grund an dieser Stelle als Ausnahme ausgelöst. Du kannst ihn mit try...catch behandeln. Auch gewöhnliche Werte und Thenables – Objekte mit einer aufrufbaren then-Methode – werden akzeptiert.

await unterbricht die laufende Ausführung einer asynchronen Funktion oder eines Moduls, nicht den gesamten Thread. Auch ein gewöhnlicher Wert oder ein bereits erfülltes Promise führt dazu, dass die Ausführung asynchron fortgesetzt wird. Deshalb erscheint im Beispiel outside vor 42. await selbst verlagert die Berechnung nicht in einen anderen Thread.

Verwende es im Rumpf einer async-Funktion (auch eines asynchronen Generators) oder auf der obersten Ebene eines Moduls. Ein gewöhnliches Skript oder eine gewöhnliche Funktion, die innerhalb einer async-Funktion verschachtelt ist, erhält diese Berechtigung nicht. await benötigt einen Operanden und darf nicht in Parameterinitialisierern asynchroner Funktionen vorkommen. Die Verwendung als Bezeichner ist kontextabhängig eingeschränkt; vermeide diesen Namen.

Aufeinanderfolgende await-Anweisungen können unabhängige Vorgänge unnötig nacheinander ausführen. Um auf mehrere unabhängige Vorgänge gemeinsam zu warten, starte sie zuerst und verwende dann await Promise.all(...). Die Unterstützung der await-Syntax belegt nicht, dass in der Umgebung eine bestimmte Web-API verfügbar ist.

Beispiele

async function main() {
  console.log("start");
  const value = await Promise.resolve(42);
  console.log(value);
}

main().catch(console.error);
console.log("outside");

Ergebnis

start
outside
42

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