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

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 赋值会触发跳转，但行为取决于资源加载状态：

page-agent 浏览器控制（CDP）

使用 page-agent CLI（CDP）控制浏览器；CLI只能通过 GitHub Release 的 .tgz 安装，npm 官方包暂未发布。

下载

• 若目标位置已缓冲，跳转几乎立即生效
• 若未缓冲，浏览器会触发 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 做高精度同步（比如歌词滚动），应优先用服务端时间戳 + 播放起始偏移来校准。