MediaError:code 属性

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

只读属性 MediaError.code 返回一个数值,该数值表示媒体元素上发生的错误的类型。要获取包含具体诊断信息的文本字符串,请参阅 MediaError.message

一个表示发生的错误通用类型的数值。可能的值将在 Media 错误代码常量 中进行描述。

Media 错误代码常量

名称 描述
MEDIA_ERR_ABORTED 1 关联资源的获取已由用户请求中止。
MEDIA_ERR_NETWORK 2 发生某种网络错误,导致媒体无法成功获取,尽管它以前是可用的。
MEDIA_ERR_DECODE 3 尽管以前已确定该媒体资源可用,但在尝试解码时发生错误,从而导致了错误。
MEDIA_ERR_SRC_NOT_SUPPORTED 4 发现关联的资源或媒体提供者对象(例如 MediaStream)不合适。

示例

此示例创建了一个 <video> 元素,为其设置了错误处理程序,然后将该元素的 src 属性设置为要在元素中显示的视频资源。错误处理程序会输出一条消息

js
const obj = document.createElement("video");
obj.onerror = () => {
  console.error(`Error with media: ${obj.error.code}`);
};
obj.src = "https://example.com/blahblah.mp4";

规范

规范
HTML
# dom-mediaerror-code-dev

浏览器兼容性

另见

  • MediaError:用于定义 MediaError.code 属性的接口