HTMLMediaElement: played property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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
js
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
Specification |
---|
HTML # dom-media-played-dev |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
played |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.