canplay事件表示浏览器已获取足够媒体数据可开始播放但不保证不中断；它在加载头部、缓冲若干帧或解码器就绪时触发，readyState为2，适合启用控件而非自动播放。
canplay 事件在 HTML5 中表示浏览器已获取足够媒体数据（如视频或音频），可以开始播放，但**不保证后续不会因缓冲而中断**。它比 canplaythrough 触发更早，适合用于“准备就绪”的轻量提示或启动 UI 交互，而非判断“全程无卡顿”。
何时触发 canplay？
当浏览器完成以下至少一项时触发：
- 已加载并解析了媒体文件头部（metadata）
- 缓冲区已有若干帧/音频采样（通常 ≥ 1–3 秒，具体取决于浏览器和网络）
- 解码器已就绪，能立即解码并输出第一帧
⚠️ 注意：此时 video.readyState 值为 2（HAVE_ENOUGH_DATA），但 video.buffered.length 可能很小，且播放后仍可能暂停等待更多数据。
正确监听 canplay 的写法
推荐在 <video> 或 <audio> 元素上直接绑定，确保在加载过程中捕获事件：
立即学习“前端免费学习笔记（深入）”；
<video id="myVideo" src="example.mp4"></video>
<script>
const video = document.getElementById('myVideo');
// ✅ 推荐：监听 canplay，同时检查 readyState
video.addEventListener('canplay', () => {
console.log('已可播放，当前 readyState:', video.readyState); // 通常为 2
if (video.readyState >= 2) {
// 可安全调用 play()，或启用播放按钮
document.getElementById('playBtn').disabled = false;
}
});
// ❌ 避免仅依赖 canplay 后立刻自动播放（尤其移动端）
// 因部分浏览器要求用户手势触发，否则静音或拒绝播放
</script>
canplay vs canplaythrough：关键区别
两者都表示“可播放”，但语义和适用场景不同：
- canplay：数据够播“开头几秒”，适合启用控件、显示封面、预加载字幕等
-
canplaythrough：浏览器预估当前带宽+缓冲足以从头到尾连续播放完毕（
readyState === 4），适合自动播放、跳转后确认就绪
例如：用户点击播放按钮后，你希望立即响应 —— 用 canplay；你想在视频完全加载好后才显示“重播”按钮 —— 用 canplaythrough。
实用建议与避坑点
- 不要把
canplay当作“已加载完成”信号，loadeddata或loadedmetadata更侧重元数据就绪 - 结合
video.networkState和video.error判断是否加载异常（如 404、跨域失败） - 移动端 Safari 对自动播放限制严格，即使触发
canplay，也需用户手势后才能真正play() - 动态设置
src后，需重新监听事件（旧监听器不会自动迁移）
不复杂但容易忽略：canplay 是“能力就绪”的起点，不是“体验保障”的终点。
