WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

window.onerror — globale Behandlung von Skriptfehlern

window.onerror verarbeitet error-Ereignisse, die dem Fenster gemeldet werden. Bei einem ErrorEvent erhält die Funktion fünf Argumente. Die Rückgabe von true unterdrückt die standardmäßige Fehlermeldung, setzt den unterbrochenen Code aber nicht fort.

Version: 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 ist die Ereignis-Handler-Eigenschaft des Window-Objekts für error und dient dazu, nicht abgefangene Skriptfehler zu beobachten. Sie gehört zum HTML-Standard und nicht zu einer bestimmten ECMAScript-Ausgabe. Aktuelle Browser-Engines unterstützen sie; dass ein Repository Node 24 enthält, belegt nicht die Unterstützung dieser Browser-API.

Bei einem ErrorEvent erhält die Funktion message (Fehlermeldung), source (Skript-URL), lineno (Zeile), colno (Spalte) und error (den gemeldeten Wert, der nicht unbedingt ein Error-Objekt ist). Details können fehlen: Bei unterdrückten Cross-Origin-Skriptfehlern lauten die Meldung Script error., die URL ist leer, die Koordinaten sind 0 und error ist null.

Die Rückgabe von genau true unterdrückt die standardmäßige Meldung; false und undefined tun das nicht. Dadurch wird der Fehler weder behoben noch die unterbrochene Ausführung fortgesetzt. window.addEventListener("error", handler) erhält ein einzelnes Ereignisobjekt; zum Abbrechen dient event.preventDefault(), nicht der Rückgabewert.

Eine Zuweisung ersetzt den bisherigen Handler; mit null wird er entfernt. Nicht behandelte Promise-Ablehnungen werden über unhandledrejection behandelt, nicht über window.onerror. Das Beispiel löst ein synthetisches ErrorEvent mit festgelegten Daten aus und stellt den vorherigen Handler wieder her; es erzeugt keinen echten, nicht abgefangenen Fehler.

Beispiele

(() => {
  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;
  }
})();

Ergebnis

Demo|demo.js|7|3|true
canceled=true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen