Page Visibility API
一句话解释
Page Visibility API 让你得知页面标签页是否被隐藏(切换走或最小化),以便暂停工作。
用大白话说
Page Visibility API 告诉你页面当前是否对用户可见。当用户切换到另一标签页或最小化浏览器时,document.visibilityState 变为 "hidden" 并触发 visibilitychange 事件。返回时变为 "visible"。这对资源管理很有价值:标签页隐藏时暂停视频或动画(没必要渲染无人看的帧)、节流轮询或分析、停止游戏循环,或减少耗电工作。它也避免误导性指标——标签页隐藏时可暂停页面停留时间统计。API 很简单:读 document.visibilityState("visible" 或 "hidden")并监听 visibilitychange 事件。document.hidden 是布尔快捷方式。可与 requestAnimationFrame 结合以自动暂停渲染循环。
示例
javascript
document.addEventListener("visibilitychange", () => {
if (document.hidden) {
console.log("Tab hidden — pausing video");
video.pause();
} else {
console.log("Tab visible — resuming");
video.play();
}
});用户切走时 document.hidden 变 true,视频暂停。回到标签页时恢复播放。
相关术语
相关资源
相关课程
- 页面生命周期
学习可见性与生命周期。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。