大网数据广告活动
Web 标准与前端开发

HTMLMediaElement:canplay 事件

· 52CE 我爱测

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

HTMLMediaElement

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

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

语法

在类似 EventTarget.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("视频可以开始播放,但是不一定能够完整地播放。");
};

规范

浏览器兼容性

相关事件

  • HTMLMediaElement HTMLMediaElement.playing_event 事件
  • HTMLMediaElement HTMLMediaElement.waiting_event 事件
  • HTMLMediaElement HTMLMediaElement.seeking_event 事件
  • HTMLMediaElement HTMLMediaElement.seeked_event 事件
  • HTMLMediaElement HTMLMediaElement.ended_event 事件
  • HTMLMediaElement HTMLMediaElement.loadedmetadata_event 事件
  • HTMLMediaElement HTMLMediaElement.loadeddata_event 事件
  • HTMLMediaElement HTMLMediaElement.canplay_event 事件
  • HTMLMediaElement HTMLMediaElement.canplaythrough_event 事件
  • HTMLMediaElement HTMLMediaElement.durationchange_event 事件
  • HTMLMediaElement HTMLMediaElement.timeupdate_event 事件
  • HTMLMediaElement HTMLMediaElement.play_event 事件
  • HTMLMediaElement HTMLMediaElement.pause_event 事件
  • HTMLMediaElement HTMLMediaElement.ratechange_event 事件
  • HTMLMediaElement HTMLMediaElement.volumechange_event 事件
  • HTMLMediaElement HTMLMediaElement.suspend_event 事件
  • HTMLMediaElement HTMLMediaElement.emptied_event 事件
  • HTMLMediaElement HTMLMediaElement.stalled_event 事件

参见

  • HTMLAudioElement
  • HTMLVideoElement
  • audio
  • video

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。