CKTIS / JavaScript
HTMLElement.onerror — de error-gebeurtenis afhandelen
HTMLElement.onerror wijst een handler toe voor de error-gebeurtenis van een element, bijvoorbeeld wanneer het laden van een afbeelding mislukt. Het is geen globaal mechanisme om JavaScript-uitzonderingen op te vangen.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.onerror = function (event) { /* handle error */ };
element.onerror = null;HTMLElement.onerror is de event-handler-eigenschap voor error. Bij een gewoon element ontvangt de functie één eventobject, niet de vijf argumenten die bij globale foutafhandeling horen.
Een functie toewijzen vervangt de vorige waarde van deze eigenschap; null toewijzen verwijdert de handler. Gebruik addEventListener('error', handler) om onafhankelijke functies te registreren.
Verwar deze eigenschap niet met window.onerror: bij het melden van een uitzondering ontvangt de globale handler message, source, lineno, colno, error, en de waarde true retourneren annuleert de gebeurtenis. Bij een gewoon element annuleert false retourneren de gebeurtenis alleen als deze annuleerbaar is. De onerror-eigenschappen van body en frameset sturen gebeurtenissen op een speciale manier door naar Window.
Het voorbeeld verzendt een synthetische gebeurtenis zonder bronnen op te halen. Het controleert of de handler wordt aangeroepen en verwijderd, niet of er daadwerkelijk een laadfout optreedt. Dit is een browser-API die door HTML is gedefinieerd, geen functie van de ECMAScript-taal; Node 24 toont niet aan dat deze beschikbaar is.
Voorbeelden
(() => {
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'));
})();Resultaat
error: true
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.