CKTIS / JavaScript
HTMLElement.onerror — gestire l’evento error
HTMLElement.onerror assegna un gestore all’evento error di un elemento, ad esempio in caso di errore nel caricamento di un’immagine. Non è un meccanismo globale per intercettare le eccezioni JavaScript.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
element.onerror = function (event) { /* handle error */ };
element.onerror = null;HTMLElement.onerror è la proprietà di gestione dell’evento error. Su un elemento ordinario, la funzione riceve un oggetto evento, non i cinque argomenti associati alla gestione globale degli errori.
Assegnare una funzione sostituisce il valore precedente di questa proprietà; assegnare null rimuove il gestore. Per registrare funzioni indipendenti, usa addEventListener('error', handler).
Non confondere questa proprietà con window.onerror: quando segnala un’eccezione, il gestore globale riceve message, source, lineno, colno, error, e restituire true annulla l’evento. Su un elemento ordinario, restituire false annulla l’evento solo se è annullabile. Le proprietà onerror di body e frameset hanno un comportamento speciale che inoltra l’evento a Window.
L’esempio invia un evento sintetico senza recuperare risorse. Verifica l’invocazione e la rimozione del gestore, non un effettivo errore di caricamento. È un’API del browser definita da HTML, non una funzionalità del linguaggio ECMAScript; Node 24 non ne dimostra la disponibilità.
Esempi
(() => {
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'));
})();Risultato
error: true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.