CKTIS / HTML
onerror — een foutgebeurtenis afhandelen
Het onerror-attribuut bevat JavaScript dat een error-gebeurtenis afhandelt, bijvoorbeeld wanneer een afbeelding niet kan worden geladen. Handlers op elementen verschillen van window.onerror in hun argumenten en in de betekenis van hun retourwaarde.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<img onerror="/* JavaScript using event */" alt="">
element.onerror = function (event) { /* ... */ };
window.onerror = function (message, source, lineno, colno, error) { /* ... */ };onerror is een attribuut voor het afhandelen van de gebeurtenis error. De waarde is JavaScript-code, geen URL. Op een gewoon element zoals img ontvangt de code event. De bijbehorende JavaScript-eigenschap kan worden ingesteld op een functie of op null om de handler te verwijderen.
window.onerror heeft een speciale signatuur: bij een ErrorEvent ontvangt het message, source, lineno, colno, error. true retourneren annuleert de gebeurtenis alleen als die annuleerbaar is en onderdrukt zo een eventuele standaardfoutmelding. Een synthetisch ErrorEvent is standaard niet annuleerbaar, dus true retourneren annuleert het niet. true retourneren hervat de uitvoering van onderbroken code niet. Een gewone elementhandler gebruikt return false om een gebeurtenis te annuleren als die annuleerbaar is. Een callback die aan addEventListener('error', ...) wordt doorgegeven, ontvangt één gebeurtenisobject; de retourwaarde ervan annuleert de gebeurtenis niet.
Op het body-element handelt het onerror-attribuut Window-gebeurtenissen af, niet lokale fouten van het body-element. Verwar dit niet met het afhandelen van resourcefouten op img.
Het voorbeeld verstuurt een synthetische error-gebeurtenis en heeft dus geen netwerktoegang of daadwerkelijke laadfout nodig. Als JavaScript is ingeschakeld en inline handlers zijn toegestaan, hoort het output-element error weer te geven. De test controleert of de handler wordt aangeroepen, niet of de afbeelding wordt geladen.
Voorbeelden
<!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>Resultaat
error
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.