KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onrejectionhandled — een Promise-afwijzing later afhandelen

Het body-attribuut onrejectionhandled registreert een handler voor het rejectionhandled-event van Window: een eerder niet-afgehandelde Promise-afwijzing heeft later alsnog een handler gekregen.

Versie: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<body onrejectionhandled="handler(event)">
window.onrejectionhandled = handler;

onrejectionhandled op body is een event-handlerattribuut voor Window, geen gewone gebeurtenis die bij het element zelf hoort. De bijbehorende eigenschap is window.onrejectionhandled.

Het rejectionhandled-event treedt op wanneer een eerder als niet-afgehandeld gemelde afwijzing later alsnog wordt afgehandeld. event.promise verwijst naar de promise en event.reason bevat de reden van de afwijzing. Het registreren van deze event-handler handelt de afwijzing niet zelf af; de promise moet bijvoorbeeld met .catch() worden afgehandeld.

Het voorbeeld wacht op unhandledrejection en voegt daarna in een latere taak .catch() toe. preventDefault() onderdrukt de standaardmelding van het eerste event, maar handelt de promise niet af. De pagina hoort handled: demo weer te geven.

Voorbeelden

<!doctype html>
<meta charset="utf-8">
<title>rejectionhandled demo</title>
<body onrejectionhandled="if (event.promise === window.demoPromise) document.getElementById('result').textContent = 'handled: ' + event.reason">
<pre id="result">waiting</pre>
<script>
window.addEventListener('unhandledrejection', (event) => {
  if (event.promise !== window.demoPromise) return;
  event.preventDefault();
  setTimeout(() => {
    event.promise.catch(() => {});
  }, 0);
});
window.demoPromise = Promise.reject('demo');
</script>
</body>

Resultaat

handled: 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