Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti