Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onerror — gestire un evento di errore

L’attributo onerror contiene JavaScript che gestisce un evento error, ad esempio quando un’immagine non riesce a caricarsi. I gestori sugli elementi differiscono da window.onerror per gli argomenti e per il significato del valore restituito.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<img onerror="/* JavaScript using event */" alt="">
element.onerror = function (event) { /* ... */ };
window.onerror = function (message, source, lineno, colno, error) { /* ... */ };

onerror è un attributo di gestione dell’evento error. Il suo valore è codice JavaScript, non un URL. Su un elemento normale come img, il codice riceve event. La proprietà JavaScript corrispondente può essere assegnata a una funzione oppure impostata su null per rimuovere il gestore.

window.onerror ha una firma speciale: per un ErrorEvent riceve message, source, lineno, colno, error. Restituire true annulla l’evento solo se è annullabile, impedendo così l’eventuale segnalazione predefinita dell’errore. Un ErrorEvent sintetico non è annullabile per impostazione predefinita, quindi restituire true non lo annulla. Restituire true non riprende l’esecuzione del codice interrotto. Un normale gestore di elemento usa return false per annullare un evento, se è annullabile. Una funzione di callback passata a addEventListener('error', ...) riceve un solo oggetto evento e il suo valore restituito non annulla l’evento.

Sull’elemento body, l’attributo onerror gestisce eventi Window, non gli errori locali dell’elemento body. Non confonderlo con la gestione degli errori delle risorse su img.

L’esempio invia un evento error sintetico, quindi non richiede né accesso alla rete né un effettivo errore di caricamento. Con JavaScript abilitato e i gestori inline consentiti, l’elemento output dovrebbe mostrare error. Il test verifica l’invocazione del gestore, non il caricamento dell’immagine.

Esempi

<!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>

Risultato

error

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