应使用 visibilitychange 事件替代轮询,它能可靠捕获标签切换、最小化、锁屏等所有不可见场景;需在 document 上一次性注册监听,根据 visibilityState 清除/恢复 setInterval,并配合 AbortController 中断 pending 的 fetch 请求。

用 visibilitychange 事件替代轮询逻辑
页面切到后台时,setInterval 或 setTimeout 不会自动停止,心跳请求照发,既耗电又浪费后端资源。HTML5 的 visibilitychange 是唯一标准信号,比 blur/focus 更可靠——它能捕获标签切换、最小化、锁屏等所有“不可见”场景。
不要在 setInterval 回调里加 if (document.hidden) return 这类兜底判断,那只是掩盖问题:定时器仍在运行,主线程被持续唤醒。
- 监听必须注册在
document上,且只注册一次:document.addEventListener('visibilitychange', handler) -
handler中根据document.visibilityState === 'hidden'来决定是否清除轮询 - 务必保存轮询的
timerId(比如let heartbeatTimer = null),否则无法clearInterval(heartbeatTimer) - 恢复可见时,别直接重设
setInterval,先检查是否已存在有效 timer,避免重复启动
结合 layui 的弹层关闭/打开时机做二次控制
用户可能在弹层中操作(如提交表单、查看详情),此时页面虽可见,但业务上不需要轮询。layui 的 layer.open 提供 success 和 end 钩子,可与可见性逻辑协同:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 弹层打开时(
success),临时暂停轮询:clearInterval(heartbeatTimer) - 弹层关闭时(
end),若页面仍可见(document.visibilityState === 'visible'),再恢复轮询 - 注意:不要在
end里无条件重启,否则用户切走标签再回来,会触发两次恢复逻辑
避免常见失效陷阱
visibilitychange 看似简单,但在实际项目中极易失效,核心原因是状态管理混乱或监听时机错误:
立即学习“前端免费学习笔记(深入)”;
- 监听注册太晚:比如在
layui.use回调里才加addEventListener,而轮询已在ready阶段启动,中间窗口期请求已发出 - 没处理 iframe 场景:若页面嵌在 iframe 中,
document.visibilityState反映的是父页面状态,需用window.parent.document判断(但跨域受限) - iOS Safari 延迟触发:快速切标签再切回,事件可能合并或延迟数毫秒,不能依赖“立即停止”,要配合防抖或状态快照(如记录上次可见时间)
- 忘记清理:轮询被清除后,若页面刷新或路由跳转未重置
timerId,后续恢复逻辑可能作用于旧 id,静默失败
fetch 轮询必须配 AbortController
如果轮询用的是 fetch(),仅靠清除定时器不够——正在 pending 的请求不会自动中断,会继续占用连接、消耗响应体、甚至触发错误回调。
- 每次发起
fetch前创建新AbortController:const controller = new AbortController() - 传入
signal: controller.signal,并在隐藏时调用controller.abort() - 不要复用同一个
controller,否则多次abort()会报错AbortError - 注意:
abort()后 fetch promise 会 reject,需在catch中忽略该错误,避免未处理的 promise rejection


















