KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

window.onerror — globale afhandeling van scriptfouten

window.onerror verwerkt error-gebeurtenissen die aan het venster worden gemeld. Bij een ErrorEvent ontvangt de functie vijf argumenten. Als de functie true retourneert, wordt de standaardrapportage van de fout onderdrukt, maar wordt de uitvoering van de onderbroken code niet hervat.

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.onerror = (message, source, lineno, colno, error) => { /* return true to cancel default reporting */ };
window.onerror = null;

window.onerror is de gebeurtenis-handler-eigenschap voor error van het Window-object en wordt gebruikt om niet-afgevangen scriptfouten te observeren. Deze eigenschap hoort bij de HTML-standaard, niet bij een bepaalde ECMAScript-editie. Huidige browserengines ondersteunen haar; de aanwezigheid van Node 24 in een repository bewijst niet dat deze browser-API wordt ondersteund.

Bij een ErrorEvent ontvangt de functie message (foutmelding), source (script-URL), lineno (regel), colno (kolom) en error (de gemelde waarde, die niet per se een Error-object is). Details kunnen ontbreken: bij gedempte cross-origin-scriptfouten is de melding Script error., is de URL leeg, zijn de coördinaten 0 en is error gelijk aan null.

Precies true retourneren annuleert de standaardmelding; false en undefined doen dat niet. Dit herstelt de fout niet en hervat de onderbroken uitvoering niet. window.addEventListener("error", handler) ontvangt één gebeurtenisobject; annuleren gebeurt met event.preventDefault(), niet met de retourwaarde.

Een toewijzing vervangt de vorige handler; null verwijdert die. Niet-afgehandelde Promise-afwijzingen worden afgehandeld via unhandledrejection, niet via window.onerror. Het voorbeeld verstuurt een synthetische ErrorEvent met vaste gegevens en herstelt de vorige handler; het veroorzaakt geen echte, niet-afgevangen uitzondering.

Voorbeelden

(() => {
  const previous = window.onerror;
  const failure = new Error("Demo");
  window.onerror = (message, source, lineno, colno, error) => {
    console.log(`${message}|${source}|${lineno}|${colno}|${error === failure}`);
    return true;
  };
  try {
    const event = new ErrorEvent("error", {
      message: "Demo",
      filename: "demo.js",
      lineno: 7,
      colno: 3,
      error: failure,
      cancelable: true
    });
    window.dispatchEvent(event);
    console.log(`canceled=${event.defaultPrevented}`);
  } finally {
    window.onerror = previous;
  }
})();

Resultaat

Demo|demo.js|7|3|true
canceled=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