KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Promise — bewerkingsresultaten en de functies resolve/reject

Een Promise staat voor een toekomstig resultaat of een foutreden. Lees hoe de executor synchroon wordt uitgevoerd, hoe resolve en reject de uitkomst bepalen en hoe then en catch die uitkomst asynchroon afhandelen.

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

new Promise((resolve, reject) => { /* report completion */ });
promise.then(onFulfilled, onRejected);
promise.catch(onRejected);

Promise staat voor het resultaat van een bewerking die mogelijk pas later eindigt. De status is pending, fulfilled of rejected; de laatste twee zijn definitief. Een promise maken verplaatst het werk niet vanzelf naar een andere thread.

new Promise(executor) roept de executor synchroon aan en geeft daarbij de functies resolve en reject mee. resolve(value) vervult de promise met een gewone waarde of neemt de uitkomst over van een promise of thenable, een object met een aanroepbare then-methode. reject(reason) wijst de promise af; gebruik bij voorkeur een Error als reden. De eerste aanroep van een van beide functies blokkeert volgende aanroepen, ook als de overgenomen uitkomst nog pending is. Oplossen betekent dus niet altijd dat de promise meteen wordt vervuld.

De retourwaarde van de executor wordt genegeerd. Een synchrone uitzondering die daarin wordt gegooid, wijst de promise af, tenzij resolve of reject al is aangeroepen. Handlers die met then zijn geregistreerd, worden asynchroon uitgevoerd nadat de huidige uitvoering is afgelopen. then geeft een nieuwe promise terug: een geretourneerde waarde bepaalt de uitkomst daarvan, terwijl een gegooide uitzondering die afwijst. catch handelt afwijzingen af.

In het voorbeeld schrijft de executor executor en schrijft synchrone code sync vóór result: 42. De aanroep van reject na resolve(21) heeft geen effect. Het voorbeeld vereist een runtime met Promise en console; het gaat niet uit van extra Web-API’s of een bepaalde browserversie.

Voorbeelden

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");

Resultaat

executor
sync
result: 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.

Bronnen