Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

onerror — obsluha chybovej udalosti

Atribút onerror obsahuje JavaScript, ktorý obsluhuje udalosť error, napríklad keď sa nepodarí načítať obrázok. Obslužné rutiny na prvkoch sa od window.onerror líšia argumentmi aj významom návratovej hodnoty.

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

Syntax

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

onerror je atribút obslužnej rutiny udalosti error. Jeho hodnotou je kód JavaScriptu, nie URL. Na bežnom prvku, napríklad img, dostane kód event. Zodpovedajúcej vlastnosti JavaScriptu možno priradiť funkciu alebo ju nastaviť na null, čím sa obslužná rutina odstráni.

window.onerror má špeciálnu signatúru: pre ErrorEvent prijíma message, source, lineno, colno, error. Vrátenie hodnoty true zruší udalosť len vtedy, ak ju možno zrušiť, a tým potlačí prípadné predvolené hlásenie chyby. Syntetickú udalosť ErrorEvent v predvolenom nastavení nemožno zrušiť, takže ju vrátenie hodnoty true nezruší. Vrátenie hodnoty true neobnoví vykonávanie prerušeného kódu. Bežná obslužná rutina prvku používa return false na zrušenie udalosti, ak ju možno zrušiť. Callback odovzdaný do addEventListener('error', ...) dostane jeden objekt udalosti a jeho návratová hodnota udalosť nezruší.

Na prvku body obsluhuje atribút onerror udalosti Window, nie miestne chyby prvku body. Nezamieňajte si ho s obsluhou chýb zdrojov na img.

Príklad odošle syntetickú udalosť error, takže nepotrebuje prístup k sieti ani skutočné zlyhanie načítania. Ak je povolený JavaScript aj inline obslužné rutiny, prvok output by mal zobraziť error. Test overuje vyvolanie obslužnej rutiny, nie načítanie obrázka.

Príklady

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

Výsledok

error

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje