CKTIS / HTML
onerror — obsługa zdarzenia błędu
Atrybut onerror zawiera kod JavaScript obsługujący zdarzenie error, np. przy nieudanym ładowaniu obrazu. Obsługa na elemencie różni się od window.onerror liczbą argumentów i znaczeniem wartości zwracanej.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<img onerror="/* JavaScript using event */" alt="">
element.onerror = function (event) { /* ... */ };
window.onerror = function (message, source, lineno, colno, error) { /* ... */ };onerror jest atrybutem obsługi zdarzenia error. Jego wartość to kod JavaScript, a nie adres URL. Na zwykłym elemencie, np. img, kod otrzymuje event. Odpowiadającą właściwość JavaScript można ustawić na funkcję albo null, aby usunąć procedurę obsługi.
window.onerror ma specjalną sygnaturę: dla ErrorEvent otrzymuje message, source, lineno, colno, error. Zwrócenie true anuluje to zdarzenie tylko wtedy, gdy jest ono anulowalne, i w ten sposób zapobiega ewentualnemu domyślnemu raportowaniu błędu. Syntetyczne zdarzenie ErrorEvent domyślnie nie jest anulowalne, więc zwrócenie true go nie anuluje. Zwrócenie true nie wznawia przerwanego kodu. Zwykła procedura elementu używa return false do anulowania zdarzenia, o ile jest ono anulowalne. Funkcja przekazana do addEventListener('error', ...) otrzymuje jeden obiekt zdarzenia, a jej wartość zwracana nie anuluje zdarzenia.
Na elemencie body atrybut onerror obsługuje zdarzenia Window, a nie lokalne błędy elementu body. Nie należy utożsamiać go z obsługą błędu zasobu na img.
Przykład wysyła syntetyczne zdarzenie error, więc nie wymaga sieci ani faktycznego błędu ładowania. Przy włączonym JavaScript i dozwolonych procedurach inline element output powinien wyświetlić error. Test sprawdza wywołanie procedury, nie mechanizm ładowania obrazu.
Przykłady
<!doctype html>
<meta charset="utf-8">
<title>onerror</title>
<img id="image" src="data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==" alt="Demo" onerror="document.getElementById('result').textContent = event.type;">
<output id="result"></output>
<script>
document.getElementById('image').dispatchEvent(new Event('error'));
</script>Wynik
error
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.