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.