CKTIS / JavaScript
HTMLElement.onerror — obrada događaja error
HTMLElement.onerror dodjeljuje rukovatelj događaju error elementa, primjerice pri neuspjelom učitavanju slike. To nije globalni mehanizam za hvatanje JavaScript iznimki.
Verzija: 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 svojstvo je rukovatelja događajem error. Na običnom elementu funkcija prima jedan objekt događaja, a ne pet argumenata povezanih s globalnom obradom pogrešaka.
Dodjela funkcije zamjenjuje prethodnu vrijednost tog svojstva; dodjela vrijednosti null uklanja rukovatelj. Za registraciju neovisnih funkcija upotrijebi addEventListener('error', handler).
Nemoj miješati ovo svojstvo s window.onerror: pri prijavi iznimke globalni rukovatelj prima message, source, lineno, colno, error, a vraćanje vrijednosti true otkazuje događaj. Na običnom elementu vraćanje vrijednosti false otkazuje događaj samo ako se on može otkazati. Svojstva onerror elemenata body i frameset imaju posebno ponašanje koje prosljeđuje događaj objektu Window.
Primjer šalje sintetički događaj bez dohvaćanja resursa. Provjerava pozivanje i uklanjanje rukovatelja, a ne stvarnu pogrešku pri učitavanju. Ovo je API preglednika definiran standardom HTML, a ne značajka jezika ECMAScript; Node 24 ne potvrđuje njegovu dostupnost.
Primjeri
(() => {
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.