WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Promise.prototype.then — asynchrone Vorgänge verketten

Promise.prototype.then registriert Handler für Erfüllung oder Ablehnung und gibt ein neues Promise zurück. Das Ergebnis des Handlers bestimmt, wie die Kette weiterläuft.

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.then(onFulfilled, onRejected)

Promise.prototype.then akzeptiert die optionalen Handler onFulfilled und onRejected. Der erste erhält den Erfüllungswert, der zweite den Ablehnungsgrund. Der Aufruf gibt ein neues Promise zurück. Die Handler werden asynchron ausgeführt, nachdem der aktuelle synchrone Code beendet ist – auch wenn das ursprüngliche Promise bereits abgeschlossen ist.

Ein zurückgegebener gewöhnlicher Wert erfüllt das neue Promise, während eine ausgelöste Ausnahme es ablehnt. Wird ein Promise oder ein Objekt mit einer aufrufbaren then-Methode zurückgegeben, übernimmt das neue Promise dessen späteres Ergebnis. Wird kein return verwendet, ist das Ergebnis undefined. Gib asynchrone Vorgänge zurück, damit die Kette auf sie wartet.

Nicht aufrufbare Argumente gelten als fehlende Handler: Der Erfüllungswert oder Ablehnungsgrund wird weitergereicht. onRejected fängt keine Ausnahme ab, die onFulfilled im selben then-Aufruf auslöst; behandle sie in einem späteren Kettenglied. Eine normale Rückgabe aus onRejected kann den Ablauf wieder zur Erfüllung führen.

Dies ist ein ECMAScript-Mechanismus und keine Web-API. Die Methode erfordert ein echtes Promise als this; eine vorhandene then-Methode allein genügt nicht. Das Beispiel veranschaulicht verzögerte Verarbeitung, Wertumwandlung und Fehlerbehandlung mit Wiederherstellung.

Beispiele

console.log('start');

Promise.resolve(3)
  .then(value => value * 2)
  .then(value => {
    console.log(value);
    throw new Error('boom');
  })
  .then(undefined, error => {
    console.log(error.message);
    return 9;
  })
  .then(value => console.log(value));

console.log('end');

Ergebnis

start
end
6
boom
9

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