The read-only property MediaError.code returns a numeric value which represents the kind of error that occurred on a media element. To get a text string with specific diagnostic information, see MediaError.message.
Syntax
var myError = mediaError.code;
Value
A numeric value indicating the general type of error which occurred. The possible values are described below, in Media error code constants.
Media error code constants
| Name | Value | Description |
|---|---|---|
MEDIA_ERR_ABORTED |
1 |
The fetching of the associated resource was aborted by the user's request. |
MEDIA_ERR_NETWORK |
2 |
Some kind of network error occurred which prevented the media from being successfully fetched, despite having previously been available. |
MEDIA_ERR_DECODE |
3 |
Despite having previously been determined to be usable, an error occurred while trying to decode the media resource, resulting in an error. |
MEDIA_ERR_SRC_NOT_SUPPORTED |
4 |
The associated resource or media provider object (such as a MediaStream has been found to be unsuitable. |
Example
This example creates a <video> element, establishes an error handler for it, and then sets the element's src attribute to the video resource to present in the element. The error handler simply outputs a message
var obj = document.createElement('video');
obj.onerror = function() {console.log("Error with media: " + obj.error.code);}
obj.src="https://example.com/blahblah.mp4";
Specifications
| Specification | Status | Comment |
|---|---|---|
| WHATWG HTML Living Standard The definition of 'MediaError.code' in that specification. |
Living Standard | Initial definition |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | 3.5 (1.9.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
- The interface defining it,
MediaError.