KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

unhandledrejection — niet-afgehandelde Promise-afwijzing

Het unhandledrejection-event meldt een Promise-afwijzing die nog niet is afgehandeld wanneer de browser deze meldt. Het biedt de Promise en de reden van afwijzing; het is bedoeld voor diagnose en vervangt geen lokale foutafhandeling.

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

window.addEventListener("unhandledrejection", (event) => { /* event.promise, event.reason */ });

unhandledrejection is een gebeurtenis van het Web-platform die als PromiseRejectionEvent naar een globaal object, zoals window, wordt verzonden. Het is geen ECMAScript-syntaxis. event.promise verwijst naar de afgewezen Promise en event.reason bevat de reden van afwijzing — een willekeurige waarde, niet noodzakelijk een Error-object.

De melding is asynchroon: de browser houdt rekening met handlers die tijdens de verwerking van microtaken worden toegevoegd en controleert vóór het verzenden van de gebeurtenis opnieuw of de afwijzing is afgehandeld. Daarom garandeert Promise.reject() op zichzelf geen gebeurtenis. Een tijdig toegevoegde .catch() kan deze voorkomen; een handler die na de melding wordt toegevoegd, kan een afzonderlijke rejectionhandled-gebeurtenis veroorzaken.

De gebeurtenis kan worden geannuleerd. event.preventDefault() onderdrukt de standaardmelding in de console voor die afwijzing, maar verandert de status van de Promise niet en vervangt .catch() of try/catch rond await niet. Gebruik dit bewust om te voorkomen dat fouten verborgen blijven. Dit mechanisme is geen volledig foutenlogboek: tracking wordt overgeslagen voor scripts met de vlag muted errors, ook in sommige gevallen met cross-originscripts.

Het voorbeeld filtert gebeurtenissen op basis van de identiteit van de Promise, logt de reden en verwijdert de listener. Voer het uit als script op een lege browserpagina, niet in Node.js. Deze API is vastgelegd in de HTML Living Standard; een ECMAScript-editie of de aanwezigheid van Node 24 bewijst niet dat browsers de API ondersteunen.

Voorbeelden

(() => {
  let rejected;

  function report(event) {
    if (event.promise !== rejected) return;
    event.preventDefault();
    window.removeEventListener("unhandledrejection", report);
    console.log("unhandled:", event.reason);
  }

  window.addEventListener("unhandledrejection", report);
  rejected = Promise.reject("demo");
})();

Resultaat

unhandled: demo

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