W3cubDocs

/Web APIs

MediaError: code property

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

js

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 Standard
# dom-mediaerror-code-dev

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
code 3 12 3.5 9 ≤12.1 3.1 ≤37 18 4 ≤12.1 2 1.0

See also

  • MediaError: Interface used to define the MediaError.code property

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MediaError/code