HTML5中可用<audio>标签结合localStorage实现播放历史与偏好记忆：监听play/ended/timeupdate事件记录音频信息并结构化存储，限制条数；按URL单独保存进度、音量等状态，加载时恢复；读取历史渲染UI，注意跨设备限制与隐私模式兼容性。
在 HTML5 中，用 <audio> 标签配合浏览器本地存储（如 localStorage）实现播放历史与偏好记忆，核心是监听播放行为、结构化保存数据，并在页面加载时恢复状态。不需后端，纯前端即可完成。
监听播放事件并记录历史
通过监听 play、ended 或 timeupdate 事件，捕获用户正在听的歌曲信息（如标题、URL、时长、当前播放时间等），然后存入 localStorage。
示例逻辑：
- 每次调用
audio.play()前或触发play事件时，提取音频源信息（可用audio.src或自定义data-*属性） - 构造一条播放记录对象，例如：
{ title: "夜曲", src: "music/yequ.mp3", playedAt: Date.now(), duration: 248, position: 0 } - 用
JSON.stringify()转为字符串，存入localStorage.setItem('playHistory', ...) - 为避免数组过大，可限制最多保存 50 条，用
Array.slice(-50)截取最新记录
保存播放进度与偏好设置
用户可能中途关闭页面，下次打开希望从断点继续。这时需监听 timeupdate（建议节流至 5–10 秒一次），并记录当前 audio.currentTime；同时可保存音量、是否循环、是否静音等状态。
立即学习“前端免费学习笔记（深入）”；
推荐做法：
- 为每个音频 URL 单独存一个进度对象，例如：
localStorage.setItem('progress_' + encodeURIComponent(src), JSON.stringify({ time: audio.currentTime, volume: audio.volume, muted: audio.muted })) - 页面加载后，检查是否有对应进度记录，有则在
loadedmetadata后调用audio.currentTime = savedTime - 音量和静音状态可在
audio元素挂载后直接赋值（注意部分浏览器需用户手势触发后才允许设音量）
读取历史并在 UI 中展示
页面初始化时，从 localStorage 读取历史数据，解析为数组，渲染到播放列表或“最近听过”区域。
注意事项：
- 使用
JSON.parse(localStorage.getItem('playHistory') || '[]')安全读取，防止解析失败 - 对重复播放同一首歌的情况，可去重（按
src或title），并更新playedAt时间保持最新 - 若音频文件路径变更，旧记录会失效，建议在播放前用
fetch()简单探测资源是否存在，再决定是否跳过或清理
处理跨设备与隐私限制
localStorage 是域名级、仅限同源且不跨设备。如果需要同步，需搭配服务端或 Web Sync API（如 Chrome 的 chrome.storage.sync），但纯网页场景下应明确告知用户“历史仅保存在当前浏览器”。
补充提醒：
- Safari 在无痕模式下会禁用
localStorage，需用try...catch包裹写入操作 - 敏感偏好（如自动播放开关）可单独存为布尔值：
localStorage.setItem('autoPlayEnabled', 'true') - 清除历史功能应提供按钮，调用
localStorage.removeItem('playHistory')并刷新 UI
