HTML5音视频错误处理需绑定在video/audio元素上,结合error.code与networkState、readyState等状态交叉判断,并用canPlayType()预判格式支持性,分层给出可操作提示。

HTML5 中的 和 元素通过原生的 error 事件捕获加载失败,但它**只在资源加载阶段触发**,不覆盖播放中解码失败、卡顿或静音策略拦截等场景。想真正用好它,关键不是监听就完事,而是结合状态信号做交叉判断,并区分错误类型给出可操作反馈。
正确绑定 error 事件的位置和时机
error 事件必须绑定在 或 元素本身,而不是 标签——后者不支持该事件(曾有开发者误将 @error 绑定在 上,结果始终不触发)。同时需注意:
- 绑定应在元素插入 DOM 后、设置
src或之前完成,否则可能错过早期错误 - 若使用动态
src(如 Vue 的:src),确保@error与:src在同一标签层级,避免因响应式更新顺序导致监听失效 - 不要依赖内联
onerror属性(如onerror="handle()"),它无法接收事件对象,也不利于调试和复用
仅靠 error.code 不够,必须交叉验证状态
video.error?.code 是起点,但不同值代表不同含义,且浏览器行为差异大:
-
code = 2(MEDIA_ERR_NETWORK):常见于 404、跨域、MIME 类型错误(如服务器返回 text/html)、广告屏蔽插件拦截 CDN。此时
video.networkState === NETWORK_NO_SOURCE或NETWORK_IDLE,且video.readyState === 0 -
code = 3(MEDIA_ERR_DECODE):不是“格式不支持”,而是已开始加载但解码器崩溃或关键帧损坏。需同时满足:
video.readyState ≤ HAVE_METADATA+video.networkState === NETWORK_NO_SOURCE,再配合video.videoWidth === 0或连续stalled事件确认 -
code = 4(MEDIA_ERR_SRC_NOT_SUPPORTED):所有
均未被识别为可播放格式。此时canPlayType()对每个 type 返回空字符串,说明浏览器根本没尝试加载
预判比补救更有效:用 canPlayType() 提前过滤
别等 error 触发才处理。对每个 的 type,调用 video.canPlayType(type) 并严格比对返回值:
- 返回
"probably":可放心加载 - 返回
"maybe":建议作为备选,不主推 - 返回空字符串:浏览器明确不支持,跳过该 source
- 务必写全 codecs 参数,例如
type="video/mp4; codecs="avc1.64001f"",单写video/mp4在 Safari 或旧 Android 上易误判
用户提示不能只说“出错了”,要分层可操作
不同错误对用户影响不同,提示方式应差异化:
- code = 1(用户中止):不提示,仅记录日志。比如页面跳转、标签页关闭导致加载取消
-
code = 2(网络失败):显示底部 toast,文案如“视频加载失败,请检查网络”,附「重试」按钮,点击后执行
video.load(); video.play(); -
code = 3 或 4:提示“当前设备暂不支持该格式”,并自动切换到已知兼容的备用 source(如从 WebM 切回 MP4),同时添加
data-attempted-fallback防止循环降级
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











