MediaError: code property
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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.
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.
|
Examples
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 outputs a message
const obj = document.createElement("video");
obj.onerror = () => {
console.error(`Error with media: ${obj.error.code}`);
};
obj.src = "https://example.com/blahblah.mp4";
Specifications
| Specification |
|---|
| HTML # dom-mediaerror-code-dev |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
code
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
See also
MediaError: Interface used to define theMediaError.codeproperty