Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLElement.onerror — obsługa zdarzenia error

HTMLElement.onerror ustawia funkcję obsługującą zdarzenie error elementu, na przykład błąd ładowania obrazu. Nie jest to globalny mechanizm przechwytywania wyjątków JavaScript.

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

element.onerror = function (event) { /* handle error */ };
element.onerror = null;

HTMLElement.onerror to właściwość obsługi zdarzenia error. Dla zwykłego elementu funkcja otrzymuje jeden obiekt zdarzenia, a nie pięć argumentów charakterystycznych dla globalnej obsługi błędów.

Przypisanie funkcji zastępuje poprzednią wartość tej właściwości; przypisanie null usuwa tę obsługę. Aby zarejestrować niezależne funkcje, użyj addEventListener('error', handler).

Nie myl tej właściwości z window.onerror: przy raportowaniu wyjątku globalna funkcja otrzymuje message, source, lineno, colno, error, a zwrócenie true anuluje zdarzenie. Dla zwykłego elementu zwrócenie false anuluje zdarzenie tylko wtedy, gdy jest anulowalne. Właściwości onerror elementów body i frameset mają specjalne przekierowanie do Window.

Przykład wysyła syntetyczne zdarzenie bez pobierania zasobów. Sprawdza wywołanie funkcji i jej usunięcie, nie rzeczywistą awarię ładowania. To API przeglądarki zdefiniowane przez HTML, nie funkcja samego ECMAScript; Node 24 nie dowodzi jego dostępności.

Przykłady

(() => {
  const element = document.createElement('img');
  element.onerror = function (event) {
    console.log(`${event.type}: ${event.target === element}`);
  };
  element.dispatchEvent(new Event('error'));
  element.onerror = null;
  element.dispatchEvent(new Event('error'));
})();

Wynik

error: true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła