Element: error event

The error event is fired on an Element object when a resource failed to load, or can't be used. For example, if a script has an execution error or an image can't be found or is invalid.

Bubbles No
Cancelable No
Interface Event or UIEvent
Event handler property onerror

The event object is a UIEvent instance if it was generated from a user interface element, or an Event instance otherwise.


Live example


<div class="controls">
  <button id="img-error" type="button">Generate image error</button>
  <img class="bad-img" />

<div class="event-log">
  <label>Event log:</label>
  <textarea readonly class="event-log-contents" rows="8" cols="30"></textarea>


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

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

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



Specification Status
UI Events Working Draft

Browser compatibility

BCD tables only load in the browser

See also

  • This event on Window targets: error event