Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

onerror — obravnava dogodka napake

Atribut onerror vsebuje JavaScript za obravnavo dogodka error, na primer ko se slika ne naloži. Oskrbovalniki na elementih se od window.onerror razlikujejo po argumentih in pomenu vrnjene vrednosti.

Različica: 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 za obravnavo dogodka error. Njegova vrednost je koda JavaScript, ne URL. Pri običajnem elementu, kot je img, koda prejme event. Ustrezni lastnosti JavaScript lahko dodelite funkcijo ali jo nastavite na null in tako odstranite oskrbovalnik.

window.onerror ima posebno podpisno obliko: za ErrorEvent prejme message, source, lineno, colno, error. Če oskrbovalnik vrne true, se dogodek prekliče le, če ga je mogoče preklicati, s čimer se prepreči morebitno privzeto poročanje o napaki. Sintetičnega dogodka ErrorEvent privzeto ni mogoče preklicati, zato ga vrnjena vrednost true ne prekliče. Vrnitev vrednosti true ne nadaljuje izvajanja prekinjene kode. Običajni oskrbovalnik elementa uporabi return false za preklic dogodka, če ga je mogoče preklicati. Povratna funkcija, posredovana funkciji addEventListener('error', ...), prejme en objekt dogodka, njena vrnjena vrednost pa dogodka ne prekliče.

Na elementu body atribut onerror obravnava dogodke Window, ne pa lokalnih napak elementa body. Ne zamenjujte ga z obravnavo napak virov na img.

Primer sproži sintetični dogodek error, zato ne potrebuje dostopa do omrežja ali dejanske napake pri nalaganju. Če je JavaScript omogočen in so dovoljeni vstavljeni oskrbovalniki, bi moral element output prikazati error. Preizkus preverja klic oskrbovalnika, ne nalaganja slike.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri