CKTIS / HTML
onerror — обработване на събитие за грешка
Атрибутът onerror съдържа JavaScript за обработване на събитие error, например когато изображение не може да се зареди. Обработчиците върху елементи се различават от window.onerror по аргументите и значението на върнатата стойност.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<img onerror="/* JavaScript using event */" alt="">
element.onerror = function (event) { /* ... */ };
window.onerror = function (message, source, lineno, colno, error) { /* ... */ };onerror е атрибут за обработване на събитието error. Стойността му е JavaScript код, а не URL. При обикновен елемент като img кодът получава event. На съответното JavaScript свойство може да се присвои функция или да се зададе null, за да се премахне обработчикът.
window.onerror има специален подпис: за ErrorEvent получава message, source, lineno, colno, error. Връщането на true отменя събитието само ако то може да бъде отменено, като така предотвратява евентуалното съобщаване за грешката по подразбиране. По подразбиране синтетично събитие ErrorEvent не може да бъде отменено, затова връщането на true не го отменя. Връщането на true не възобновява изпълнението на прекъснатия код. Обикновеният обработчик на елемент използва return false, за да отмени събитие, ако то може да бъде отменено. Callback, подаден на addEventListener('error', ...), получава един обект на събитие, а върнатата от него стойност не отменя събитието.
Върху елемента body атрибутът onerror обработва събития Window, а не локални грешки на елемента body. Не го бъркайте с обработването на грешки на ресурси върху img.
Примерът изпраща синтетично събитие error, затова не са нужни нито мрежов достъп, нито действителен неуспешен опит за зареждане. При разрешен JavaScript и позволени inline обработчици елементът output трябва да покаже error. Тестът проверява извикването на обработчика, а не зареждането на изображение.
Примери
<!doctype html>
<meta charset="utf-8">
<title>onerror</title>
<img id="image" src="data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==" alt="Demo" onerror="document.getElementById('result').textContent = event.type;">
<output id="result"></output>
<script>
document.getElementById('image').dispatchEvent(new Event('error'));
</script>Резултат
error
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.