HTMLMediaElement.error

The HTMLMediaElement.error is the MediaError object for the most recent error, or null if there has not been an error. When an error event is received by the element, you can determine details about what happened by examining this object.

Syntax

var myError = HTMLMediaElement.error;

Value

A MediaError object describing the most recent error to occur on the media element or null if no errors have occurred.

Example

This example establishes a video element and adds an error handler to it; the error handler simply logs the details to console.

var videoElement = document.createElement('video');
videoElement.onerror = function() {
  console.log("Error " + videoElement.error.code + "; details: " + videoElement.error.message);
}
videoElement.src = "https://example.com/bogusvideo.mp4";

Specifications

Specification Status Comment
WHATWG HTML Living Standard
The definition of 'HTMLMediaElement.error' in that specification.
Living Standard No change from HTML5
HTML5
The definition of 'HTMLMediaElement.error' in that specification.
Recommendation Initial definition.

Browser compatibility

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) 3.5 (1.9.1) [1] 9 ? ?
Feature Android Edge Firefox Mobile (Gecko) Firefox OS (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) ? (Yes) (Yes)

See also

Document Tags and Contributors

 Contributors to this page: Sheppy, erikadoyle, markg
 Last updated by: Sheppy,