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.