play函数不记忆播放位置,需用localStorage在pause/ended时存currentTime、loadedmetadata/canplay后读取并设置,注意Safari限制和多视频key唯一性。

play 函数本身不记住播放位置,得自己存
浏览器原生的 play() 函数只是触发播放,它不保存、不读取、也不关心你上次播到哪。所谓“续播”,其实是你主动把 currentTime 存下来,下次播放前再设回去。
常见错误现象:play() 调用后视频从头开始;刷新页面后进度丢失;多个视频共用同一存储 key 导致串位。
- 必须在用户交互(如点击)后调用
play(),否则多数浏览器会静音拦截或直接拒绝 - 存位置不能只靠
timeupdate实时写入 localStorage——太频繁,卡顿且易丢最后几秒 - 推荐在
pause事件和ended事件里各存一次,兼顾准确性和性能
用 localStorage + currentTime 实现最简续播
这是兼容性最好、代码最少的方案,适用于单个视频页或明确知道 video 元素唯一性的场景。
使用场景:新闻页嵌入单个 、内部工具页、无登录态的轻量应用。
- 存的时候用唯一 key,比如
video-resume-time-123,别直接用resumeTime - 读的时候先检查
localStorage.getItem()是否为有效数字,避免NaN导致播放失败 - 设置
currentTime必须在loadedmetadata或canplay之后,否则可能被忽略
示例关键片段:
const video = document.querySelector('video');
const key = 'video-resume-time-' + video.dataset.id;
video.addEventListener('loadedmetadata', () => {
const saved = localStorage.getItem(key);
if (saved && !isNaN(saved)) {
video.currentTime = parseFloat(saved);
}
});
video.addEventListener('pause', () => {
localStorage.setItem(key, video.currentTime.toString());
});
video.addEventListener('ended', () => {
localStorage.removeItem(key); // 播完清空,避免下次误续
});
多视频/路由跳转时,currentTime 存储容易失效
当页面有多个 ,或用户从列表页点进详情页再返回,仅靠 DOM 顺序或 data-id 不够稳定——组件重渲染、SSR、服务端生成 ID 不一致都会让 key 对不上。
参数差异:localStorage 是全局域,但 key 命名逻辑若依赖 DOM 状态(比如 document.querySelectorAll('video')[0]),就不可靠。
- 优先用视频资源 URL 的哈希值做 key,比如
md5(video.src)(可用简单哈希函数替代) - 如果视频是动态加载的(如懒加载、分片播放),需确保
src已赋值再计算 key - Vue/React 中,不要在 unmounted 或 useEffect cleanup 里删 localStorage,除非确认用户已看完
Safari 和 iOS WebKit 的特殊限制
不是所有浏览器都允许未播放前设置 currentTime。Safari 尤其严格:如果视频还没触发过播放(哪怕只是 play().catch()),直接设 currentTime 可能无效,且不报错。
性能 / 兼容性影响:iOS 上 loadedmetadata 触发时机不稳定,有时比 canplay 还晚;部分旧版 Safari 甚至要求先 play() 再 pause() 才能设时间点。
- 稳妥做法:先调一次
play().catch(e => {})(静音、自动暂停),等canplay后再设currentTime并pause() - 别依赖
seeking或seeked来判断是否设置成功,iOS 下它们可能不触发 - 测试时务必真机验证,模拟器和桌面 Safari 表现常有偏差
currentTime 设置时机没对上——这些地方没有银弹,只能一个个 case 对着测。










