await

Der await Operator wird genutzt, um auf ein Promise zu warten. Er kann nur in einer async Funktion benutzt werden.

Syntax

[rv] = await expression;

expression

Ein Promise oder jeder Wert, auf den gewartet wird.

rv

Gibt den ermittelten Wert des Promise zurück, oder den Wert selber, wenn es kein Promise ist.

Beschreibung

Der await Ausdruck lässt async Funktionen pausieren, bis ein Promise fertig ist, indem es Erfolgreich oder nicht Erfolgreich beendet wird, und führt die async danach weiter aus. Wenn die Funktion weiter ausgeführt wird, ist der Wert des await Ausdrucks der ermittelte Wert des Promise.

Wenn der Promise nicht erfolgreich war, schmeißt der await Ausdruck den zurückgewiesenen Wert.

Wenn der Wert des Ausdrucks, der auf den await Operator folgt, kein Promise ist, wird dieser zu einem fertigen Promise konvertiert.

Beispiele

Wenn ein Promise im await Ausdruck genutzt wird, wartet dieser, bis das Promise fertig ist und gibt den ermittelten Wert zurück.

function resolveAfter2Seconds(x) { 
  return new Promise(resolve => {
    setTimeout(() => {
      resolve(x);
    }, 2000);
  });
}

async function f1() {
  var x = await resolveAfter2Seconds(10);
  console.log(x); // 10
}
f1();

Wenn der Wert kein Promise ist, wird dieser zu einem fertigen Promise konvertiert und es wird darauf gewartet.

async function f2() {
  var y = await 20;
  console.log(y); // 20
}
f2();

Wird ein Promise nicht erfolgreich beendet, wird der zurückgewiesene Wert geworfen.

async function f3() {
  try {
    var z = await Promise.reject(30);
  } catch(e) {
    console.log(e); // 30
  }
}
f3();

Abfangen von zurückgewiesenen Promises ohne try-Block.

var response = await promisedFunction().catch((err) => { console.log(err); });
// response will be undefined if the promise is rejected

Spezifikationen

Browserkompatibilität

Siehe auch

• async Funktion
• async Funktionsausdruck
• AsyncFunction Objekt