最常用方式是直接设置 currenttime,但需先监听 loadedmetadata 确保元数据加载;拖动进度条用 input 事件实时更新,max 动态设为 duration;跳转前用 math.min 防越界,移动端注意 play() 必须由用户手势触发且 currenttime 设置后可能需额外处理。

点击按钮跳转到固定时间点
直接改 currentTime 是最常用的方式,但必须确认音频已加载元数据,否则会静默失败。常见错误是页面一加载就执行 audio.currentTime = 60,此时 audio.duration 还是 NaN,跳转无效。
- 先监听
loadedmetadata事件,确保audio.readyState >= 2 - 按钮点击时计算目标时间,用
Math.min(newPos, audio.duration)防止越界 - 跳转后建议调用
audio.play()(如果处于暂停状态) - 示例:
document.getElementById('skipTo1m').addEventListener('click', () => { if (audio.readyState >= 2) audio.currentTime = 60; });
拖动 range 输入框实时更新进度
input 事件比 change 更关键——它在拖动过程中持续触发,才能实现“所见即所得”的快进/倒退体验。很多初学者用 change,结果只能松手后才跳转,交互感差。
-
range的max必须动态设为audio.duration,不能写死成 100 - 首次加载时
audio.duration可能为NaN,需等loadedmetadata后再设置seekBar.max = audio.duration - 映射公式是:
audio.currentTime = (seekBar.value / seekBar.max) * audio.duration - iOS 上
timeupdate触发频率较低(约每 250ms 一次),别依赖它做高精度同步
快进/倒退按钮的边界处理
用户猛点“+30s”按钮容易超出总时长,导致 currentTime 被设为大于 duration 的值,此时播放器行为不一致:Chrome 会自动归零并触发 ended,Safari 可能卡住或静音。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 每次跳转前必须校验:
const newPos = Math.min(audio.currentTime + 30, audio.duration); - 跳转后检查
audio.currentTime实际值,它可能被浏览器修正(比如设为duration时实际取到duration - 0.001) - 若
newPos >= audio.duration,可主动触发audio.pause()并重置 UI(如按钮变回“播放”态)
iOS 和 Android 的特殊限制
移动端不是单纯“加个事件监听就行”。iOS 要求所有 play() 必须由用户手势触发;Android 某些定制系统会忽略 currentTime 设置,除非先 pause() 再 play()。
- 不要在非用户操作上下文(如定时器、Ajax 回调)里调用
audio.play(),会 Promise reject - 拖动进度条后,iOS 可能需要额外调用
audio.play().catch(e => console.warn('play failed:', e))才能恢复播放 - 安卓 WebView 中,
currentTime设值后立即读取可能仍是旧值,需等下一个timeupdate或seeked事件再更新 UI
真实场景里,最难缠的是 duration 不稳定和移动端策略差异。别假设所有浏览器都按规范走,每个跳转动作都要带兜底判断和 fallback 行为。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










