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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.