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.