База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

HTMLElement.onerror — обработване на събитието error

HTMLElement.onerror задава обработчик за събитието error на даден елемент, например при неуспешно зареждане на изображение. Това не е глобален механизъм за прихващане на JavaScript изключения.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

HTMLElement.onerror е свойството за обработчик на събитието error. При обикновен елемент функцията получава един обект на събитие, а не петте аргумента, свързани с глобалното обработване на грешки.

Задаването на функция заменя предишната стойност на това свойство; задаването на null премахва обработчика. За да регистрираш независими функции, използвай addEventListener('error', handler).

Не бъркай това свойство с window.onerror: при докладване на изключение глобалният обработчик получава message, source, lineno, colno, error, а връщането на true отменя събитието. При обикновен елемент връщането на false отменя събитието само ако то може да бъде отменено. Свойствата onerror на body и frameset имат специално поведение, което препраща събитието към Window.

Примерът изпраща синтетично събитие, без да зарежда ресурси. Той проверява извикването и премахването на обработчика, а не действителен неуспешен опит за зареждане. Това е API на браузъра, дефинирано от HTML, а не функция на езика ECMAScript; Node 24 не доказва, че то е налично.

Примери

(() => {
  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'));
})();

Резултат

error: true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници