WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Promise.resolve — einen Wert in ein Promise umwandeln

Mit Promise.resolve(value) lässt sich ein gewöhnlicher Wert, ein Promise oder ein Thenable wie ein Promise behandeln. Ein vorhandenes Promise kann unverändert zurückgegeben werden; resolved bedeutet weder, dass das Ergebnis bereits verfügbar ist, noch dass der Vorgang erfolgreich sein wird.

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.resolve(value)

Promise.resolve(value) ist eine statische Methode, die einen Wert in ein Promise umwandelt. Wird das Argument weggelassen, gilt undefined. Erstellt die Methode ein neues Promise, wird es mit dem Argument erfüllt, wenn dieses ein primitiver Wert oder ein Objekt ist, dessen Eigenschaft then sich ohne Ausnahme auslesen lässt und einen nicht aufrufbaren Wert liefert. Wird beim Zugriff auf then eine Ausnahme ausgelöst, wird das neue Promise mit dieser Ausnahme als Grund abgelehnt.

Ist p ein echtes Promise, liest Promise.resolve(p) dessen Eigenschaft constructor aus. Ergibt der Zugriff Promise, gibt die Methode genau p zurück. Wirft der Getter für constructor eine Ausnahme, gibt die Methode diese synchron weiter, bevor ein neues Promise erstellt wird. Das gilt auch dann, wenn die Auswertung des Arguments p selbst erfolgreich war. Die Methode erstellt ein neues Promise, wenn das Argument kein echtes Promise ist oder wenn der Zugriff auf dessen constructor einen anderen Wert als Promise ergibt. Ein Thenable, also ein Objekt mit einem aufrufbaren then, wird assimiliert, und das Ergebnis folgt dessen Abwicklung, auch über weitere Thenables hinweg. Eine Ablehnung bleibt eine Ablehnung; resolved bedeutet nicht fulfilled.

An .then() übergebene Callbacks werden asynchron ausgeführt, selbst wenn das Promise bereits erfüllt ist. Die Methode fängt keine Fehler ab, die beim Auswerten des Arguments entstehen: Wirft fn() in Promise.resolve(fn()) einen Fehler, wirft der Aufruf synchron. Um den Aufruf aufzuschieben und einen solchen Fehler in eine Ablehnung umzuwandeln, verwende Promise.resolve().then(() => fn()).

Beispiele

const p = Promise.resolve(7);
console.log(Promise.resolve(p) === p);

const thenable = { then(resolve) { resolve(42); } };
Promise.resolve(thenable).then(value => console.log(value));
console.log("sync");

Ergebnis

true
sync
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