HTML | DOM 音频 currentTime 属性

currentTime 是 HTML 音频元素（<audio>）和视频元素（<video>）的 DOM 属性之一。它代表了媒体资源当前播放的时间位置（以秒为单位）。

语法

let currentPlaybackTime = mediaElement.currentTime;
mediaElement.currentTime = newTime;

• mediaElement：代表了一个 HTML 音频元素或视频元素。
• currentPlaybackTime：返回当前媒体资源播放的时间位置，以秒为单位。
• newTime：要设置的新的时间位置，以秒为单位。

示例

使用 JavaScript 来获取和设置 currentTime 属性：

const audio = document.querySelector('#my-audio');
console.log(audio.currentTime); // 打印当前播放时长

// 设置当前播放位置为 30s
audio.currentTime = 30;

注意事项

• 如果 currentTime 属性的设置值超出了媒体资源的持续时间，那么播放器将会自动停止播放。
• currentTime 属性也可以被设置为负数，但不是所有的浏览器都支持此行为。
• 尝试设置 currentTime 属性可能会导致浏览器从新的时间位置开始播放媒体资源。
• 如果尝试在媒体资源还未加载完成时设置 currentTime 属性，可能会导致媒体源的加载失败。
• currentTime 属性是可读写的。

参考

• HTML DOM currentTime 属性