HTMLMediaElement: played-Eigenschaft
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die played-Eigenschaft, eine schreibgeschützte Eigenschaft der Schnittstelle HTMLMediaElement, zeigt die Zeitbereiche an, in denen die Ressource, eine <audio>- oder <video>-Mediendatei, abgespielt wurde. Sie gibt ein neues TimeRanges-Objekt zurück, das die Bereiche der Medienquelle enthält, die der Browser zum Zeitpunkt der Auswertung der Eigenschaft abgespielt hat.
Wert
Ein TimeRanges-Objekt, das die abgespielten Zeitbereiche darstellt.
Beispiele
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.`);
Spezifikationen
| Specification |
|---|
| HTML # dom-media-played-dev |