CKTIS / HTML
onerror — obsluha chybové události
Atribut onerror obsahuje JavaScript, který obsluhuje událost error, například když se nepodaří načíst obrázek. Obslužné rutiny na prvcích se od window.onerror liší argumenty i významem návratové hodnoty.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<img onerror="/* JavaScript using event */" alt="">
element.onerror = function (event) { /* ... */ };
window.onerror = function (message, source, lineno, colno, error) { /* ... */ };onerror je atribut obslužné rutiny události error. Jeho hodnotou je kód JavaScriptu, nikoli URL. U běžného prvku, například img, dostane kód event. Odpovídající vlastnosti JavaScriptu lze přiřadit funkci nebo ji nastavit na null a obslužnou rutinu tak odstranit.
window.onerror má zvláštní signaturu: pro ErrorEvent přijímá message, source, lineno, colno, error. Vrácení hodnoty true zruší událost jen tehdy, pokud ji lze zrušit, a tím potlačí případné výchozí hlášení chyby. Syntetickou událost ErrorEvent ve výchozím nastavení nelze zrušit, takže ji vrácení hodnoty true nezruší. Vrácení hodnoty true neobnoví provádění přerušeného kódu. Běžná obslužná rutina prvku používá return false ke zrušení události, pokud ji lze zrušit. Callback předaný do addEventListener('error', ...) dostane jeden objekt události a jeho návratová hodnota událost nezruší.
Na prvku body obsluhuje atribut onerror události Window, nikoli místní chyby prvku body. Nezaměňujte jej s obsluhou chyb zdrojů na img.
Příklad odešle syntetickou událost error, takže nepotřebuje přístup k síti ani skutečné selhání načítání. Pokud je povolen JavaScript a také inline obslužné rutiny, měl by prvek output zobrazit error. Test ověřuje vyvolání obslužné rutiny, nikoli načítání obrázku.
Pří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ýsledek
error
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.