Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła