Skip to content

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,视频暂停。回到标签页时恢复播放。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表