KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

PromiseRejectionEvent.reason — afwijsreden van een promise

PromiseRejectionEvent.reason geeft de afwijsreden door in unhandledrejection- en rejectionhandled-gebeurtenissen. De eigenschap is alleen-lezen, maar de waarde kan elke JavaScript-waarde zijn, niet alleen een Error-object.

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

event.reason
new PromiseRejectionEvent(type, { promise, reason })

PromiseRejectionEvent is een Web-API-interface die overerft van Event en geen deel uitmaakt van ECMAScript zelf. De eigenschap PromiseRejectionEvent.reason, gelezen als event.reason, bevat de afwijsreden. Dit kan een tekenreeks, getal, Error, ander object of undefined zijn; ga er dus niet van uit dat event.reason.message bestaat.

reason is alleen-lezen. event.promise verwijst daarentegen naar de promise die bij de gebeurtenis hoort: deze eigenschappen staan respectievelijk voor de reden en de promise, niet voor twee manieren om hetzelfde uit te lezen.

unhandledrejection meldt een afwijzing waarvoor geen afwijzingshandler beschikbaar is. rejectionhandled betekent dat er later een handler is toegevoegd, nadat unhandledrejection al was gemeld. Globale listeners helpen bij de diagnose, maar vervangen foutafhandeling met .catch() of try/catch rond await niet.

Het voorbeeld maakt handmatig een gebeurtenis aan om de toegang tot de eigenschap op een voorspelbare manier te laten zien. Het constructorargument reason stelt de waarde in deze synthetische gebeurtenis in; het aanmaken van de gebeurtenis wijst geen promise af en verstuurt de gebeurtenis niet. De directe .catch() voorkomt een echte onbehandelde afwijzing.

Voer het voorbeeld uit in een browser die PromiseRejectionEvent beschikbaar maakt. Deze API is ook beschikbaar in Web Workers; de aanwezigheid van Promise of het gebruik van Node 24 bewijst niet dat deze browserinterface wordt ondersteund.

Voorbeelden

(() => {
  const reason = "TASK_FAILED";
  const promise = Promise.reject(reason);
  promise.catch(() => {});

  const event = new PromiseRejectionEvent("unhandledrejection", {
    promise,
    reason,
  });

  console.log(event.reason);
  console.log(event.promise === promise);
})();

Resultaat

TASK_FAILED
true

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