CKTIS / JavaScript
HTMLElement.onerror — spracovanie udalosti error
HTMLElement.onerror priradí obslužnú funkciu udalosti error prvku, napríklad pri zlyhaní načítania obrázka. Nie je to globálny mechanizmus na zachytávanie výnimiek JavaScriptu.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.onerror = function (event) { /* handle error */ };
element.onerror = null;HTMLElement.onerror je vlastnosť obsluhy udalosti error. Pri bežnom prvku funkcia dostane jeden objekt udalosti, nie päť argumentov spojených s globálnym spracovaním chýb.
Priradením funkcie sa nahradí predchádzajúca hodnota tejto vlastnosti; priradením null sa obsluha odstráni. Ak chceš registrovať nezávislé funkcie, použi addEventListener('error', handler).
Nezamieňaj si túto vlastnosť s window.onerror: pri oznamovaní výnimky dostane globálna obsluha message, source, lineno, colno, error a vrátenie hodnoty true udalosť zruší. Pri bežnom prvku vrátenie hodnoty false zruší udalosť iba vtedy, ak je zrušiteľná. Vlastnosti onerror prvkov body a frameset majú zvláštne správanie, ktoré udalosť presmeruje na Window.
Príklad odošle syntetickú udalosť bez načítavania zdrojov. Overuje zavolanie a odstránenie obsluhy, nie skutočné zlyhanie načítania. Ide o API prehliadača definované štandardom HTML, nie o funkciu jazyka ECMAScript; Node 24 nedokazuje jeho dostupnosť.
Prí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ýsledok
error: true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.