CKTIS / JavaScript
Promise.resolve — een waarde normaliseren naar een promise
Met Promise.resolve(value) kun je een gewone waarde, een promise of een thenable als een promise behandelen. De methode kan een bestaande promise ongewijzigd teruggeven; resolved betekent niet dat het resultaat al beschikbaar is of dat de bewerking zal slagen.
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
Promise.resolve(value)Promise.resolve(value) is een statische methode om een waarde naar een promise te normaliseren. Als je het argument weglaat, is de waarde undefined. Maakt de methode een nieuwe promise aan, dan wordt die met het argument vervuld als het een primitieve waarde is of als het een object is waarvan then zonder uitzondering kan worden uitgelezen en een niet-aanroepbare waarde oplevert. Als het uitlezen van then een uitzondering gooit, wordt de nieuwe promise afgewezen met die uitzondering als reden.
Als p een echte promise is, leest Promise.resolve(p) de eigenschap constructor van die promise uit. Levert dat Promise op, dan geeft de methode precies p terug. Gooit de getter voor constructor een uitzondering, dan geeft de methode die synchroon door voordat er een nieuwe promise wordt aangemaakt, zelfs als het evalueren van het argument p zelf lukt. De methode maakt een nieuwe promise aan als het argument geen echte promise is of als het uitlezen van de eigenschap constructor een andere waarde dan Promise oplevert. Een thenable, oftewel een object met een aanroepbare then, wordt geassimileerd en het resultaat volgt de afwikkeling ervan, ook via eventuele verdere thenables. Een afwijzing blijft een afwijzing; resolved betekent niet fulfilled.
Callbacks die aan .then() worden doorgegeven, worden asynchroon uitgevoerd, zelfs als de promise al is vervuld. De methode vangt geen fouten op die ontstaan bij het evalueren van het argument: als fn() een fout gooit in Promise.resolve(fn()), gooit de aanroep die fout synchroon. Gebruik Promise.resolve().then(() => fn()) om de aanroep uit te stellen en zo’n uitzondering om te zetten in een afwijzing.
Voorbeelden
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");Resultaat
true sync 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.