Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje