KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onunhandledrejection — niet-afgehandelde promise-afwijzing

Het attribuut onunhandledrejection op body registreert een handler voor de unhandledrejection-gebeurtenis van het Window-object. Het maakt de reden beschikbaar van een afgewezen promise waarvoor op het moment van de melding nog geen afwijzingshandler bestaat.

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

Syntax

<body onunhandledrejection="/* JavaScript using event */">

onunhandledrejection is een attribuut voor een eventhandler waarvan de waarde JavaScript-code is. Op body stelt het de handler in voor de unhandledrejection-gebeurtenis van het Window-object, niet voor een afzonderlijke gebeurtenis van het element. Het is geen gewoon globaal HTML-attribuut dat op elk element beschikbaar is. Het JavaScript-equivalent is de eigenschap window.onunhandledrejection.

De melding is asynchroon. Als er vroeg genoeg een afwijzingshandler wordt toegevoegd, treedt de gebeurtenis niet op. Het event-object is een PromiseRejectionEvent: event.promise verwijst naar de afgewezen promise en event.reason bevat de reden van de afwijzing.

Een aanroep van event.preventDefault() annuleert de standaardrapportage van deze gebeurtenis in de console; de promise wordt er niet door hersteld. Handel verwachte fouten af bij de bron, in plaats van uitsluitend op een globale melding te vertrouwen.

Het voorbeeld stelt het attribuut in op body en handelt de afwijzing van de promise af met promise.catch(() => {}). De aanroep van window.dispatchEvent() laat op window een synthetische, annuleerbare unhandledrejection-gebeurtenis plaatsvinden. Daardoor wordt de handler aangeroepen die event.reason in de console schrijft. Het voorbeeld laat zien dat de handler is gekoppeld, niet hoe de browser een niet-afgehandelde afwijzing meldt. De aanroep van event.preventDefault() geldt hier alleen voor de synthetische gebeurtenis en laat niet zien hoe de standaardmelding van de browser bij een niet-afgehandelde afwijzing wordt onderdrukt. Inline-code vereist toestemming volgens het beveiligingsbeleid van de pagina.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Body onunhandledrejection handler</title>
</head>
<body onunhandledrejection="event.preventDefault(); console.log('reason: ' + event.reason)">
  <script>
    const reason = 'demo';
    const promise = Promise.reject(reason);
    // Handle the fixture so the browser does not report a real unhandled rejection.
    promise.catch(() => {});
    window.dispatchEvent(new PromiseRejectionEvent('unhandledrejection', {
      promise,
      reason,
      cancelable: true
    }));
  </script>
</body>
</html>

Resultaat

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