媒体错误：code 属性

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

值

一个数字值，指示发生的错误的一般类型。可能的数值在下面 媒体错误代码常量 中描述。

媒体错误代码常量

名称 值 描述
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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参见

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