CKTIS / JavaScript
window.onerror — globalna obsługa błędów skryptów
window.onerror obsługuje zdarzenia error zgłaszane do okna. Dla ErrorEvent otrzymuje pięć argumentów, a zwrócenie true anuluje domyślne raportowanie błędu, lecz nie wznawia przerwanego kodu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
window.onerror = (message, source, lineno, colno, error) => { /* return true to cancel default reporting */ };
window.onerror = null;window.onerror jest właściwością obsługi zdarzenia error na obiekcie Window, używaną do obserwowania nieprzechwyconych błędów skryptów. Należy do standardu HTML, nie do konkretnej edycji ECMAScript. Jest obsługiwana przez współczesne silniki przeglądarek; obecność Node 24 w repozytorium nie potwierdza obsługi tego API przeglądarkowego.
Dla ErrorEvent funkcja otrzymuje message (komunikat), source (adres skryptu), lineno (wiersz), colno (kolumnę) i error (zgłoszoną wartość, niekoniecznie obiekt Error). Szczegóły mogą być niedostępne: wyciszone błędy skryptów między domenami mają komunikat Script error., pusty adres, współrzędne 0 i error równe null.
Zwrócenie dokładnie true anuluje domyślne raportowanie; false ani undefined tego nie robią. Nie naprawia to błędu ani nie wznawia przerwanego wykonania. window.addEventListener("error", handler) przekazuje pojedyncze zdarzenie; do anulowania używa się event.preventDefault(), nie wartości zwracanej.
Przypisanie zastępuje poprzedni handler, a null go usuwa. Nieobsłużone odrzucenia obietnic obsługuje unhandledrejection, nie window.onerror. Przykład wysyła syntetyczny ErrorEvent z ustalonymi danymi i przywraca poprzedni handler; nie powoduje rzeczywistego nieprzechwyconego wyjątku.
Przykłady
(() => {
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;
}
})();Wynik
Demo|demo.js|7|3|true canceled=true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.