KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Promise.prototype.catch — afwijzingen afhandelen

De methode catch() koppelt een afwijzingshandler aan een promise. Hiermee kun je herstellen met een succesvolle waarde of een fout doorgeven; met de standaardmethode then retourneert de methode een nieuwe promise.

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.catch(onRejected)

Promise.prototype.catch roept this.then(undefined, onRejected) aan. Met de standaardmethode then retourneert deze methode een nieuwe promise zonder de status van de oorspronkelijke promise te wijzigen. De handler onRejected ontvangt de reden voor de afwijzing, die niet per se een Error-object is, en wordt asynchroon uitgevoerd, ook als de promise al was afgewezen.

Een gewone waarde retourneren vanuit de handler vervult de nieuwe promise met die waarde; als je return weglaat, is het resultaat undefined. Als je een promise of een object met een aanroepbare then-methode retourneert, neemt de nieuwe promise de uiteindelijke uitkomst daarvan over. Een fout gooien wijst de nieuwe promise af. Gebruik throw om een fout door te geven in plaats van die alleen weer te geven.

Bij vervulling wordt de handler overgeslagen en de waarde doorgegeven. Als onRejected geen functie is, wordt ook de afwijzing doorgegeven. Een catch na then handelt ook fouten af die in die eerdere stap zijn gegooid, maar niet fouten in latere stappen of in onafhankelijke asynchrone bewerkingen die niet zijn geretourneerd.

Voorbeelden

Promise.resolve(10)
  .then(() => {
    throw new Error("failed");
  })
  .catch((error) => {
    console.log(error.message);
    return 42;
  })
  .then((value) => {
    console.log(value);
  });
console.log("sync");

Resultaat

sync
failed
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