HTMLMediaElement：currentTime 属性

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.

HTMLMediaElement 接口的 currentTime 属性指定当前的播放时间（以秒为单位）。

改变 currentTime 的值会将媒体定位（seek）到新的时间。

值

一个双精度浮点数，表示当前的播放时间（以秒为单位）。

如果媒体尚未播放，currentTime 的值表示一旦调用 play() 方法，媒体将开始播放的时间点。

将 currentTime 设置为新值会将媒体定位到给定的时间（如果媒体可用）。

对于没有已知持续时间的媒体（例如实时流式传输的媒体），浏览器可能无法从媒体缓冲区中获取已过期的媒体部分。此外，对于时间线不从 0 秒开始的媒体，无法定位到其时间线最早的时间点之前的时间。

可以使用 duration 属性确定媒体的长度（以秒为单位）。

示例

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

使用说明

降低时间精度

为了防止计时攻击和指纹识别，video.currentTime 的精度可能会根据浏览器设置进行舍入。在 Firefox 中，privacy.reduceTimerPrecision 首选项被默认启用且默认为 2ms。你还可以启用 privacy.resistFingerprinting，在这种情况下，精度将为 100ms 和 privacy.resistFingerprinting.reduceTimerPrecision.microseconds 的值中的较大值。

例如，在降低了时间精度的情况下，video.currentTime 的结果总是 0.002 的倍数，或者在 privacy.resistFingerprinting 启用的情况下，为 0.1（或 privacy.resistFingerprinting.reduceTimerPrecision.microseconds）的倍数。

js
// Firefox 60 中降低的时间精度（2ms）
video.currentTime;
// 可以是：
// 23.404
// 24.192
// 25.514
// ……

// `privacy.resistFingerprinting` 启用的情况下的降低的时间精度
video.currentTime;
// 可以是：
// 49.8
// 50.6
// 51.7
// ……

规范

Specification
HTML Standard
# dom-media-currenttime-dev

浏览器兼容性

BCD tables only load in the browser

参见