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