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
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

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support Yes Yes3.59 Yes Yes
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes Yes Yes Yes Yes Yes ?

See also

Document Tags and Contributors

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