Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

HTMLElement.onerror — zpracování události error

HTMLElement.onerror přiřazuje obslužnou funkci události error daného prvku, například při chybě načítání obrázku. Nejde o globální mechanismus pro zachytávání výjimek JavaScriptu.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

element.onerror = function (event) { /* handle error */ };
element.onerror = null;

HTMLElement.onerror je vlastnost obsluhy události error. U běžného prvku funkce obdrží jeden objekt události, nikoli pět argumentů spojených s globálním zpracováním chyb.

Přiřazením funkce se nahradí předchozí hodnota této vlastnosti; přiřazením null se obsluha odstraní. Chceš-li registrovat nezávislé funkce, použij addEventListener('error', handler).

Nezaměňuj tuto vlastnost za window.onerror: při hlášení výjimky obdrží globální obsluha message, source, lineno, colno, error a vrácení hodnoty true událost zruší. U běžného prvku vrácení hodnoty false zruší událost pouze tehdy, pokud ji lze zrušit. Vlastnosti onerror prvků body a frameset mají zvláštní chování, které událost předává objektu Window.

Příklad odešle syntetickou událost bez načítání prostředků. Ověřuje zavolání a odstranění obsluhy, nikoli skutečné selhání načítání. Jde o API prohlížeče definované standardem HTML, nikoli o funkci jazyka ECMAScript; Node 24 nedokládá jeho dostupnost.

Pří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ýsledek

error: true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje