CKTIS / JavaScript
Promise.withResolvers(): een promise met beschikbare afhandelingsfuncties
Promise.withResolvers() geeft een nieuwe promise en de bijbehorende functies resolve en reject terug. Zo kun je het aanmaken van een promise scheiden van het doorgeven van de uitkomst, bijvoorbeeld bij het aanpassen van een interface op basis van callbacks.
Versie: 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() is een statische methode uit ECMAScript 2024, geen Web-API. De methode neemt geen argumenten en geeft een gewoon object terug met de eigenschappen promise, resolve en reject. Bij Promise.withResolvers() wacht de promise aanvankelijk op een uitkomst; je geeft geen executor mee zoals bij new Promise(executor).
resolve(value) accepteert een waarde of neemt de latere uitkomst van een promise of thenable over. Een aanroep van resolve betekent dus niet altijd dat de promise meteen wordt vervuld. reject(reason) wijst de promise af. Alleen de eerste aanroep van een van beide functies telt; latere aanroepen worden genegeerd, ook als de overgenomen uitkomst nog onbekend is.
Handlers die met .then() zijn geregistreerd, worden asynchroon uitgevoerd. Het voorbeeld geeft eerst sync en daarna fulfilled: 42 weer; de aanroep van reject wordt genegeerd. Maak de afhandelingsfuncties alleen beschikbaar aan code die de uitkomst mag bepalen.
Controleer de beschikbaarheid met typeof Promise.withResolvers === "function". De specificatie alleen bewijst niet dat een bepaalde browser de methode ondersteunt; Node 24 in de repository bewijst dat evenmin.
Voorbeelden
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");Resultaat
sync fulfilled: 42
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.