CKTIS / JavaScript
HTMLElement.onerror — obravnava dogodka error
HTMLElement.onerror nastavi obravnavo dogodka error elementa, na primer ob napaki pri nalaganju slike. Ne gre za globalni mehanizem za prestrezanje izjem JavaScript.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
element.onerror = function (event) { /* handle error */ };
element.onerror = null;HTMLElement.onerror je lastnost za obravnavo dogodka error. Pri običajnem elementu funkcija prejme en objekt dogodka, ne pa petih argumentov, povezanih z globalno obravnavo napak.
Z dodelitvijo funkcije zamenjaš prejšnjo vrednost te lastnosti; z dodelitvijo null obravnavo odstraniš. Za registracijo neodvisnih funkcij uporabi addEventListener('error', handler).
Te lastnosti ne zamenjuj z window.onerror: pri poročanju o izjemi globalna obravnava prejme message, source, lineno, colno, error, vrnitev vrednosti true pa prekliče dogodek. Pri običajnem elementu vrnitev vrednosti false prekliče dogodek samo, če ga je mogoče preklicati. Lastnosti onerror elementov body in frameset imajo posebno vedenje, ki dogodek posreduje objektu Window.
Primer sproži sintetični dogodek, ne da bi pridobil vire. Preveri klic in odstranitev obravnave, ne pa dejanske napake pri nalaganju. To je API brskalnika, ki ga določa HTML, in ne funkcija jezika ECMAScript; Node 24 ne dokazuje, da je API na voljo.
Primeri
(() => {
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'));
})();Rezultat
error: true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.