Element : évènement error

L'évènement error est déclenché sur un objet Element lorsque le chargement d'une ressource a échoué ou qu'elle ne peut pas être utilisée. Cela peut, par exemple, se produire lors d'une erreur d'exécution d'un script ou lorsqu'une image ne peut être trouvée ou si elle est invalide.

Bouillonnement Non
Annulable Non
Interface Event ou UIEvent
Propriété pour la gestion d'évènement onerror

L'objet évènement obtenu est une instance UIEvent s'il a été généré depuis un élément de l'interface utilisateur ou une instance Event sinon.

Exemples

HTML

html
<div class="controls">
  <button id="img-error" type="button">Générer une erreur d'image</button>
  <img class="bad-img" />
</div>

<div class="event-log">
  <label>Journal d'évènements :</label>
  <textarea readonly class="event-log-contents" rows="8" cols="30"></textarea>
</div>

JS

js
const log = document.querySelector(".event-log-contents");

const badImg = document.querySelector(".bad-img");
badImg.addEventListener("error", (event) => {
  log.textContent = log.textContent + `${event.type}: Chargement de l'image\n`;
  console.log(event);
});

const imgError = document.querySelector("#img-error");
imgError.addEventListener("click", () => {
  badImg.setAttribute("src", "i-dont-exist");
});

Résultat

Spécifications

Specification
UI Events
# event-type-error

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

  • L'évènement correspondant pour les cibles Window : error