HTMLMediaElement.currentTime

HTMLMediaElement インターフェイスの currentTime プロパティは、現在の再生時間を秒単位で示します。

この値を変更すると、メディアは新しい時刻にシークされます。

値

現在の再生時刻を秒単位で示す倍精度浮動小数点値です。

メディアがまだ再生されていない場合、 currentTime の値は play() メソッドが呼ばれたときに再生が開始されるメディア内の時刻位置を示しています。

currentTimeに新しい値を設定すると、メディアが利用可能であれば、指定された時刻にシークします。

ライブストリーミングされたメディアなど、再生時間が不明なメディアでは、ブラウザーがメディアバッファーから時間切れのメディア部分を取得できない可能性があります。また、タイムラインが 0 秒で始まらないメディアは、そのタイムラインの最も早い時刻より前にシークすることはできません。

秒単位のメディアの長さは、 durationプロパティを用いて決定することができます。

例

const video = document.createElement('video');
console.log(video.currentTime);

使用上の注意

時間精度の引き下げ

タイミング攻撃や フィンガープリントから保護するために、ブラウザーは currentTime が返す値を丸めたり、その他の方法で調整することがあります。

仕様書

Specification
HTML Standard
# dom-media-currenttime-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報