MediaError - 处理 HTML 媒体元素时媒体发生的错误

MediaError 接口表示在基于 HTMLMediaElement 接口（例如 <audio> 或 <video>）处理 HTML 媒体元素中的媒体时发生的错误。

MediaError 对象使用分类错误类型的数字 code 和 message 来概括地描述错误，该消息提供有关错误的特定诊断。

属性

该接口不继承任何属性。

MediaError.code

表示发生的一般错误类型的数字，如下所示

名称	值	描述
MEDIA_ERR_ABORTED	1	用户的请求中止了相关资源的获取。
MEDIA_ERR_NETWORK	2	尽管先前已经可用，但是发生了某种类型的网络错误，该错误阻止了媒体被获取。
MEDIA_ERR_DECODE	3	尽管先前已确定可用，但在尝试解码媒体资源时发生错误，从而导致错误。
MEDIA_ERR_SRC_NOT_SUPPORTED	4	已发现关联的资源或媒体提供者对象（例如 MediaStream）不适用。

MediaError.message

一个 DOMString 对象，包含一个人类可读的字符串，提供特定的诊断信息，以帮助读者理解发生的错误情况；具体而言，它不仅仅是错误代码含义的摘要，而且是包含了实际的诊断信息，有助于理解究竟出了什么问题。该文本及其格式不是由规范定义的，每个 user agent 都不一样。如果没有可用的诊断信息，或者无法提供任何解释，则此值为空字符串（""）。

方法

该接口不实现或继承任何方法，并且没有自己的方法。

规范

规范	状态	备注
HTML Living Standard MediaError 的定义	现行的标准	-

桌面浏览器兼容性

移动浏览器兼容性

相关链接

• HTMLMediaElement.error