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

HTMLMediaElement: ended 事件

· 52CE 我爱测

`ended` 事件会在媒体回放或者媒体流因达到了媒体的未尾或者没有更多可用的数据而停止时被触发。

HTMLMediaElement

ended 事件会在媒体回放或者媒体流因达到了媒体的未尾或者没有更多可用的数据而停止时被触发。

该事件会在回放或媒体文件播放结束时,在HTMLMediaElement(audio 和 video)上触发。

<table class="properties"> <tbody> <tr> <th scope="row">是否冒泡</th> <td>否</td> </tr> <tr> <th scope="row">是否可取消</th> <td>否</td> </tr> <tr> <th scope="row">接口</th> <td>Event</td> </tr> <tr> <th scope="row">目标</th> <td>元素</td> </tr> <tr> <th scope="row">默认行为</th> <td>无</td> </tr> <tr> <th scope="row">事件处理器属性</th> <td>GlobalEventHandlers.onended</td> </tr> </tbody> </table>

[!NOTE] 该事件也在媒体捕捉与媒体流和 Web Audio 这两个 API 中定义。

示例

以下示例展示了如何为媒体元素的 ended 事件添加一个事件监听器,以在该事件触发时发送一条消息。

使用 addEventListener():

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

video.addEventListener("ended", (event) => {
  console.log(
    "Video stopped either because 1) it was over, " +
      "or 2) no further data is available.",
  );
});

使用 onended 事件处理器属性:

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

video.onended = (event) => {
  console.log(
    "Video stopped either because 1) it was over, " +
      "or 2) no further data is available.",
  );
};

规范

浏览器兼容性

相关事件

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

参见

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

资料来源与适用范围

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

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

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