CKTIS / HTML
onerror — gérer un événement d’erreur
L’attribut onerror contient du JavaScript qui gère un événement error, par exemple lorsqu’une image ne parvient pas à se charger. Les gestionnaires sur un élément diffèrent de window.onerror par leurs arguments et par le sens de leur valeur de retour.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<img onerror="/* JavaScript using event */" alt="">
element.onerror = function (event) { /* ... */ };
window.onerror = function (message, source, lineno, colno, error) { /* ... */ };onerror est un attribut de gestion d’événement pour error. Sa valeur est du code JavaScript, et non une URL. Sur un élément ordinaire comme img, le code reçoit event. La propriété JavaScript correspondante peut recevoir une fonction ou être définie sur null pour supprimer le gestionnaire.
window.onerror a une signature spéciale : pour un ErrorEvent, il reçoit message, source, lineno, colno, error. Renvoyer true n’annule l’événement que s’il est annulable, ce qui empêche alors tout signalement d’erreur par défaut. Un ErrorEvent synthétique n’est pas annulable par défaut : renvoyer true ne l’annule donc pas. Renvoyer true ne reprend pas l’exécution du code interrompu. Un gestionnaire ordinaire sur un élément utilise return false pour annuler un événement s’il peut être annulé. Un rappel transmis à addEventListener('error', ...) reçoit un seul objet événement, et sa valeur de retour n’annule pas l’événement.
Sur l’élément body, l’attribut onerror gère les événements Window, plutôt que les erreurs locales de l’élément body. Ne le confondez pas avec la gestion des erreurs de ressource sur img.
L’exemple déclenche un événement error synthétique : il ne nécessite donc ni accès réseau ni véritable échec de chargement. Avec JavaScript activé et les gestionnaires inline autorisés, l’élément output devrait afficher error. Ce test vérifie l’appel du gestionnaire, pas le chargement d’une image.
Exemples
<!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>Résultat
error
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.