CKTIS / JavaScript
Promise.withResolvers(): ein Promise mit zugänglichen Auflösungsfunktionen
Promise.withResolvers() gibt ein neues Promise sowie die zugehörigen Funktionen resolve und reject zurück. So lassen sich das Erstellen eines Promise und die Übergabe seines Ergebnisses trennen, etwa beim Anpassen einer callbackbasierten Schnittstelle.
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
const { promise, resolve, reject } = Promise.withResolvers();Promise.withResolvers() ist eine statische Methode aus ECMAScript 2024 und keine Web-API. Sie nimmt keine Argumente entgegen und gibt ein gewöhnliches Objekt mit den Eigenschaften promise, resolve und reject zurück. Bei Promise.withResolvers() wartet das Promise zunächst auf ein Ergebnis; anders als bei new Promise(executor) übergibst du keinen Executor.
resolve(value) akzeptiert einen Wert oder übernimmt das spätere Ergebnis eines Promise oder Thenable. Ein Aufruf von resolve bedeutet daher nicht immer eine sofortige Erfüllung. reject(reason) weist das Promise zurück. Nur der erste Aufruf einer der beiden Funktionen ist maßgeblich; spätere Aufrufe werden ignoriert, selbst wenn das übernommene Ergebnis noch unbekannt ist.
Mit .then() registrierte Handler werden asynchron ausgeführt. Das Beispiel gibt zuerst sync und dann fulfilled: 42 aus; der Aufruf von reject wird ignoriert. Stelle die Auflösungsfunktionen nur Code zur Verfügung, der das Ergebnis steuern soll.
Prüfe die Verfügbarkeit mit typeof Promise.withResolvers === "function". Die Spezifikation allein belegt nicht, dass die Methode in einem bestimmten Browser unterstützt wird; auch Node 24 im Repository belegt das nicht.
Beispiele
const { promise, resolve, reject } = Promise.withResolvers();
promise.then(
value => console.log(`fulfilled: ${value}`),
reason => console.log(`rejected: ${reason}`)
);
resolve(42);
reject("ignored");
console.log("sync");Ergebnis
sync fulfilled: 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.