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

HTMLMediaElement: played property

· 52CE 我爱测

The **`played`** read-only property of the HTMLMediaElement interface indicates the time ranges the resource, an audio or video media file, has played. It returns a new TimeRanges object that contains the ranges of the media source that the browser has played, if any, at the time

HTML DOM

The played read-only property of the HTMLMediaElement interface indicates the time ranges the resource, an audio or video media file, has played. It returns a new TimeRanges object that contains the ranges of the media source that the browser has played, if any, at the time the attribute is evaluated.

Value

A TimeRanges object; representing the time ranges that have been played.

Examples

const media = document.querySelector("audio");
const playedTimeRanges = media.played;
let timePlayed = 0;
// calculate the total time the media has played
for (let i = 0; i < playedTimeRanges.length; i++) {
  timePlayed += playedTimeRanges.end(i) - playedTimeRanges.start(i);
}
console.log(`The media played for a total of ${timePlayed} seconds.`);

Specifications

Browser compatibility

See also

  • HTMLMediaElement.seeked_event event
  • HTMLMediaElement.progress_event event
  • HTMLMediaElement.seekable
  • HTMLMediaElement.buffered
  • HTMLVideoElement
  • HTMLAudioElement

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

资料来源与适用范围

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

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

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