CKTIS / JavaScript
Promise — Operationsergebnisse und resolve-/reject-Funktionen
Ein Promise steht für ein später eintretendes Ergebnis oder einen Fehlergrund. Erfahre, wie der Executor synchron ausgeführt wird, wie resolve und reject den Ausgang festlegen und wie then und catch diesen asynchron behandeln.
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
new Promise((resolve, reject) => { /* report completion */ });
promise.then(onFulfilled, onRejected);
promise.catch(onRejected);Promise steht für das Ergebnis einer Operation, die möglicherweise erst später abgeschlossen wird. Sein Zustand ist pending, fulfilled oder rejected; die letzten beiden Zustände sind endgültig. Das Erstellen eines Promise verlagert die Arbeit nicht von selbst auf einen anderen Thread.
Bei new Promise(executor) wird der Executor synchron aufgerufen und erhält die Funktionen resolve und reject. resolve(value) erfüllt das Promise mit einem gewöhnlichen Wert oder übernimmt den Ausgang eines Promise beziehungsweise eines Thenable – eines Objekts mit einer aufrufbaren then-Methode. reject(reason) weist das Promise zurück; als Grund empfiehlt sich ein Error. Der erste Aufruf einer der beiden Funktionen sperrt weitere Aufrufe, selbst wenn der übernommene Ausgang noch pending ist. Ein Aufruf von resolve bedeutet also nicht immer sofortige Erfüllung.
Der Rückgabewert des Executors wird ignoriert. Eine synchron im Executor ausgelöste Ausnahme weist das Promise zurück, sofern resolve oder reject nicht bereits aufgerufen wurde. Über then registrierte Handler laufen asynchron, nachdem die aktuelle Ausführung abgeschlossen ist. then gibt ein neues Promise zurück: Ein zurückgegebener Wert bestimmt dessen Ausgang, während eine ausgelöste Ausnahme es zurückweist. catch behandelt Zurückweisungen.
Im Beispiel gibt der Executor executor aus; der synchrone Code gibt sync vor result: 42 aus. Der Aufruf von reject nach resolve(21) hat keine Wirkung. Das Beispiel benötigt eine Laufzeitumgebung mit Promise und console; zusätzliche Web-APIs oder eine bestimmte Browserversion werden nicht vorausgesetzt.
Beispiele
const promise = new Promise((resolve, reject) => {
console.log("executor");
resolve(21);
reject(new Error("ignored"));
});
promise
.then(value => value * 2)
.then(value => console.log(`result: ${value}`))
.catch(error => console.log(error.message));
console.log("sync");Ergebnis
executor sync result: 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.