video.buffered 返回的是浏览器已缓冲的视频时间区间(单位:秒)组成的 TimeRanges 对象,可能包含多个不连续片段;需遍历区间找出覆盖 currentTime 的那段并计算其 end 与 duration 的百分比,而非直接用 end(0)。
video.buffered 是一个 TimeRanges 对象,
不是简单的百分比数值。它记录浏览器已缓冲的视频时间区间(单位:秒),可能包含多个不连续的片段(比如用户跳播后形成两段缓冲区)。直接取 video.buffered.length 不能反映“进度”,必须计算已缓冲总时长占 video.duration 的比例。
很多代码直接写 video.buffered.end(0),这仅适用于**从开头连续缓冲**的情况。一旦用户拖动进度条或网络中断重连,video.buffered 可能有多个区间(length > 1),此时 end(0) 返回的是第一个区间的结束时间,完全不反映当前播放位置附近的缓冲状态。
video.currentTime 的那个区间,再取它的 end
function getBufferedPercent(video) {
const time = video.currentTime;
let bufferedEnd = 0;
for (let i = 0; i < video.buffered.length; i++) {
if (video.buffered.start(i) <= time && time <= video.buffered.end(i)) {
bufferedEnd = video.buffered.end(i);
break;
}
}
return video.duration ? Math.min(100, (bufferedEnd / video.duration) * 100) : 0;
}
buffered 属性本身不会触发事件,bufferedupdate 并非标准事件(Chrome 曾短暂支持但已移除)。可靠方案是监听 timeupdate,并在其中调用缓冲计算函数;或者用 setInterval 每 200–500ms 主动检查一次 —— 尤其在静音/暂停状态下,timeupdate 可能不触发,但缓冲仍在进行。
requestAnimationFrame,间隔低于 100ms 意义不大且增加开销video.duration 初始为 NaN,需等 loadedmetadata 或 canplay 事件后才可用buffered 的更新有时滞,建议结合 readyState 判断(readyState >= HTMLMediaElement.HAVE_FUTURE_DATA)增强可靠性真实场景下缓冲百分比会频繁抖动,直接用于 UI 进度条会造成闪烁。需要做简单平滑处理:
bufferedEnd 小于 currentTime 时,说明已缓冲区域落后于播放点 → 实际卡顿风险高,此时应返回 0 而非负数duration === Infinity)无法用百分比,只能用 buffered.length 和 buffered.end(i) - currentTime 计算“可回溯秒数”缓冲不是线性过程,网络波动、CDN 节点、MSE 分段加载都会影响 buffered 的表现。别把它当成精确指标,而是作为用户体验的辅助参考 —— 用户真正感知的是是否卡顿,不是数字本身。