CKTIS / JavaScript
HTMLElement.onerror — zpracování události error
HTMLElement.onerror přiřazuje obslužnou funkci události error daného prvku, například při chybě načítání obrázku. Nejde o globální mechanismus pro zachytávání výjimek JavaScriptu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.onerror = function (event) { /* handle error */ };
element.onerror = null;HTMLElement.onerror je vlastnost obsluhy události error. U běžného prvku funkce obdrží jeden objekt události, nikoli pět argumentů spojených s globálním zpracováním chyb.
Přiřazením funkce se nahradí předchozí hodnota této vlastnosti; přiřazením null se obsluha odstraní. Chceš-li registrovat nezávislé funkce, použij addEventListener('error', handler).
Nezaměňuj tuto vlastnost za window.onerror: při hlášení výjimky obdrží globální obsluha message, source, lineno, colno, error a vrácení hodnoty true událost zruší. U běžného prvku vrácení hodnoty false zruší událost pouze tehdy, pokud ji lze zrušit. Vlastnosti onerror prvků body a frameset mají zvláštní chování, které událost předává objektu Window.
Příklad odešle syntetickou událost bez načítání prostředků. Ověřuje zavolání a odstranění obsluhy, nikoli skutečné selhání načítání. Jde o API prohlížeče definované standardem HTML, nikoli o funkci jazyka ECMAScript; Node 24 nedokládá jeho dostupnost.
Příklady
(() => {
const element = document.createElement('img');
element.onerror = function (event) {
console.log(`${event.type}: ${event.target === element}`);
};
element.dispatchEvent(new Event('error'));
element.onerror = null;
element.dispatchEvent(new Event('error'));
})();Výsledek
error: true
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.