KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Promise.prototype.then — asynchrone bewerkingen aan elkaar koppelen

Promise.prototype.then registreert afhandelaars voor vervulling of afwijzing en geeft een nieuwe promise terug. Het resultaat van de afhandelaar bepaalt hoe de keten verdergaat.

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.then(onFulfilled, onRejected)

Promise.prototype.then accepteert de optionele afhandelaars onFulfilled en onRejected. De eerste ontvangt de vervullingswaarde; de tweede de reden van afwijzing. De aanroep geeft een nieuwe promise terug. De afhandelaars worden asynchroon uitgevoerd, nadat de huidige synchrone code is afgelopen, ook als de oorspronkelijke promise al is afgehandeld.

Een gewone waarde teruggeven vervult de nieuwe promise, terwijl een uitzondering gooien deze afwijst. Een promise of een object met een aanroepbare then-methode teruggeven zorgt ervoor dat de nieuwe promise de uiteindelijke uitkomst daarvan overneemt. Zonder return is het resultaat undefined. Geef asynchrone bewerkingen terug, zodat de keten erop wacht.

Niet-aanroepbare argumenten gelden als ontbrekende afhandelaars: de vervullingswaarde of afwijzingsreden wordt doorgegeven. onRejected vangt geen uitzondering op die onFulfilled in dezelfde aanroep van then gooit; handel die af in een volgende schakel. Normaal terugkeren uit onRejected kan herstel naar vervulling opleveren.

Dit is een ECMAScript-mechanisme, geen Web-API. De methode vereist een echte promise als this; alleen een then-methode hebben is niet genoeg. Het voorbeeld laat uitgestelde afhandeling, waardetransformatie en herstel na een fout zien.

Voorbeelden

console.log('start');

Promise.resolve(3)
  .then(value => value * 2)
  .then(value => {
    console.log(value);
    throw new Error('boom');
  })
  .then(undefined, error => {
    console.log(error.message);
    return 9;
  })
  .then(value => console.log(value));

console.log('end');

Resultaat

start
end
6
boom
9

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