HTMLMediaElement：canplay 事件

基线广泛可用

自 2015年7月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

canplay 事件会在用户代理可以播放媒体，但是估计没有加载足够的数据以流畅地播放媒体至结束（可能需要停顿来缓存更多内容）时触发。

此事件无法被取消也不会冒泡。

语法

在类似 addEventListener() 的方法中使用事件名，或者设置事件处理器属性。

addEventListener("canplay", (event) => {});

oncanplay = (event) => {};

通用 Event。

这些示例为 HTMLMediaElement 的 canplay 事件添加了一个事件监听器。事件处理器会在事件被触发时发送一条信息。

使用 addEventListener()：

const video = document.querySelector("video");

video.addEventListener("canplay", (event) => {
  console.log("视频可以开始播放，但是不一定能够完整地播放。");
});

使用 oncanplay 事件处理器属性：

const video = document.querySelector("video");

video.oncanplay = (event) => {
  console.log("视频可以开始播放，但是不一定能够完整地播放。");
};

规范
HTML # event-media-canplay
HTML # handler-oncanplay

此页面最后更新于 2024年9月21日，由 MDN 贡献者更新。