HTMLMediaElement: played プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

played は HTMLMediaElement インターフェイスの読み取り専用プロパティで、リソース（<audio> または <video> のメディアファイル）が再生された時間の範囲を示します。このプロパティは、この属性が評価された時点で、ブラウザーが再生したメディアソースの範囲（ある場合）を含む新しい TimeRanges オブジェクトを返します。

値

TimeRanges オブジェクトです。再生が行われた時間の範囲を示します。

例

const media = document.querySelector("audio");
const playedTimeRanges = media.played;
let timePlayed = 0;
// メディアが再生された合計時間を計算します
for (let i = 0; i < playedTimeRanges.length; i++) {
  timePlayed += playedTimeRanges.end(i) - playedTimeRanges.start(i);
}
console.log(`このメディアは合計で ${timePlayed} 秒再生されました。`);