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 July 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 Standard
# dom-media-played-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch