audio.currentTime 返回秒数而非百分比,需用 (currentTime / duration) * 100 换算;须在 loadedmetadata 后获取 duration,监听 timeupdate 事件实时更新进度,设置 currentTime 可能触发 waiting,移动端兼容性差需特别处理。
获取播放进度最直接的方式是读取 currentTime 属性,但它返回的是当前已播放的**秒数(number 类型)**,不是 0–100 的百分比。你需要手动换算:
const audio = document.querySelector('audio');
const percent = (audio.currentTime / audio.duration) * 100;注意:只有在 loadedmetadata 事件触发后,duration 才可靠;否则可能为 NaN 或 Infinity。
时获取进度currentTime 是只读属性,不能靠轮询定时器去查——既低效又不准。正确做法是监听 timeupdate 事件:
audio.addEventListener('timeupdate', () => {
console.log('当前时间:', audio.currentTime);
});该事件在播放过程中自动高频触发(通常每 200–250ms 一次),但**不会在静音、暂停或加载中触发**。如果需要更精细控制(比如拖动进度条时同步显示),要额外监听 seeking 和 seeked。
给 currentTime 赋值会触发跳转,但行为取决于资源加载状态:
waiting 事件,然后等数据加载完成才继续播放canplay 或 canplaythrough 使用,并捕获 error 事件:audio.currentTime = 30;
audio.onseeked = () => console.log('跳转完成');
audio.onerror = () => console.error('跳转失败,可能未就绪或跨域限制');在 iOS 和部分安卓 WebView 中,currentTime 的读写受限明显:
audio 元素,duration 常为 NaN,需先调用 load() 或触发一次 play()(哪怕立刻 pause())timeupdate 频率做降频处理,有时几秒才触发一次timeupdate 会停止触发,即使音频仍在播放currentTime 做高精度同步(比如歌词滚动),应优先用服务端时间戳 + 播放起始偏移来校准。