onerror Event
Example
Call a function when an error occurs while a video is being downloaded:
<video onerror="myFunction()">
More examples below.
Definition and Usage
The onerror
event occurs when an error occurs during the loading of a media.
Audio and Video Events
While loading a media, 7 events occur in the following order:
Event | Occurs When | Bubbles |
---|---|---|
onloadstart | The loading of a media starts | No |
ondurationchange | The duration of a media is changed | No |
onloadedmetadata | The meta data for a media has been loaded | No |
onloadeddata | A media frame is loaded | No |
onprogress | The browser is loading a media | No |
oncanplay | An element's scrollbar is being scrolled | No |
oncanplaythrough | The browser estimates it can play a media | No |
Other events that can occur in the media loading process:
Event | Occurs When | Bubbles |
---|---|---|
onabort | The loading of a media is aborted | No |
onemptied | A media is empty (already loaded) | No |
onerror | An error occurs while loading a media | No |
onstalled | Media data is not available | No |
onsuspend | The browser is not getting the media data | No |
See Also:
Syntax
In HTML:
<element onerror="myScript">
In JavaScript:
object.onerror = function(){myScript};
In JavaScript, using the addEventListener() method:
object.addEventListener("error", myScript);
Technical Details
Bubbles: | No |
---|---|
Cancelable: | No |
Event type: | Event |
Supported HTML tags: | <audio> and <video> |
DOM Version: | Level 3 Events |
Browser Support
onerror
is a DOM Level 3 (2004) feature.
It is fully supported in all browsers:
Chrome | Edge | Firefox | Safari | Opera | IE |
Yes | Yes | Yes | Yes | Yes | 9-11 |
❮ Event Object