Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori