Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

onerror — obrada događaja pogreške

Atribut onerror sadrži JavaScript koji obrađuje događaj error, primjerice kada se slika ne uspije učitati. Rukovatelji na elementima razlikuju se od window.onerror po argumentima i značenju povratne vrijednosti.

Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

<img onerror="/* JavaScript using event */" alt="">
element.onerror = function (event) { /* ... */ };
window.onerror = function (message, source, lineno, colno, error) { /* ... */ };

onerror je atribut rukovatelja događajem error. Njegova je vrijednost JavaScript kod, a ne URL. Na običnom elementu kao što je img, kod prima event. Odgovarajućem JavaScript svojstvu može se dodijeliti funkcija ili se svojstvo može postaviti na null kako bi se uklonio rukovatelj.

window.onerror ima poseban potpis: za ErrorEvent prima message, source, lineno, colno, error. Vraćanje vrijednosti true otkazuje događaj samo ako ga je moguće otkazati, čime se sprječava eventualno zadano prijavljivanje pogreške. Sintetički događaj ErrorEvent prema zadanim se postavkama ne može otkazati, pa ga vraćanje vrijednosti true ne otkazuje. Vraćanje vrijednosti true ne nastavlja izvršavanje prekinutog koda. Obični rukovatelj elementa koristi return false za otkazivanje događaja ako se on može otkazati. Povratni poziv predan funkciji addEventListener('error', ...) prima jedan objekt događaja, a njegova povratna vrijednost ne otkazuje događaj.

Na elementu body atribut onerror obrađuje događaje Window, a ne lokalne pogreške elementa body. Nemojte ga zamijeniti s obradom pogreške resursa na img.

Primjer šalje sintetički događaj error, pa mu nisu potrebni pristup mreži ni stvarna pogreška pri učitavanju. Ako je JavaScript omogućen i umetnuti rukovatelji dopušteni, element output trebao bi prikazati error. Test provjerava pozivanje rukovatelja, a ne učitavanje slike.

Primjeri

<!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>

Rezultat

error

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori