MDN self-hosted library · e01.org

HTMLMediaElement: played property

HTML DOM

Open notebook · 1 cells web-api-instance-property upstream source

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

  • seeked event
  • progress event
  • HTMLMediaElement.seekable
  • HTMLMediaElement.buffered
  • HTMLVideoElement
  • HTMLAudioElement