video.paused返回布尔值:true表示暂停/未开始/已结束,false表示正在播放;需结合readyState、currentTime或ended等属性及play/pause/ended事件精准判断状态。

直接读取 video 元素的 paused 属性就能判断当前是否暂停——它返回一个布尔值:true 表示已暂停或尚未开始播放,false 表示正在播放。
paused 属性的基本行为
paused 是只读属性,反映视频元素的实时播放状态。注意:它在视频未加载完成、尚未调用 play() 或播放已结束(ended 为 true)时,都返回 true。所以不能单靠它区分“暂停中”和“未开始”,需结合 readyState 或 currentTime 判断上下文。
- 刚加载完但没点播放 →
paused === true - 播放中被手动暂停 →
paused === true - 正在播放 →
paused === false - 播完最后一帧 →
paused === true(同时ended === true)
配合事件监听更可靠
仅靠轮询 paused 不够及时,推荐监听关键事件来捕获状态变化:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
-
play事件触发时,paused必然变为false -
pause事件触发时,paused必然变为true -
ended触发后,paused保持true,但此时应检查ended属性确认是否播完
实际判断逻辑示例
比如要做一个“播放/暂停”按钮切换逻辑:
const video = document.querySelector('video');
const btn = document.getElementById('toggle-btn');
btn.addEventListener('click', () => {
if (video.paused) {
video.play().catch(e => console.warn('自动播放被阻止:', e));
} else {
video.pause();
}
});
// 同步更新按钮文字
video.addEventListener('play', () => btn.textContent = '||');
video.addEventListener('pause', () => btn.textContent = '▶');
常见误判场景提醒
以下情况容易误读 paused:
- 视频还在加载(
readyState ),<code>paused是true,但不代表用户按了暂停 - 设置了
autoplay但被浏览器策略拦截,paused仍为true,需检查play()的 Promise 是否 reject - 用户拖动进度条时可能短暂触发
seeking,此时paused可能为true,但属于过渡态,不表示用户意图暂停


















