audio.currentTime 返回秒数而非百分比,需用 (currentTime / duration) * 100 换算;须在 loadedmetadata 后获取 duration,监听 timeupdate 事件实时更新进度,设置 currentTime 可能触发 waiting,移动端兼容性差需特别处理。

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










