利用 Page Visibility API 优化网页性能与用户体验

在现代 Web 开发中，用户可能会频繁切换标签页，或让网页处于后台运行。为了避免不必要的资源浪费并提升用户体验，合理利用 Page Visibility API 可以在页面不可见时暂停或减少资源的消耗，并在页面重新可见时恢复正常操作。

在这篇博客中，我将展示如何通过 Page Visibility API 实现以下场景：

当用户切换标签页时暂停视频或音频播放。
当页面不可见时停止资源密集型的动画。
页面不可见时停止 API 请求，并在页面可见时重新开始。
当用户返回页面时恢复定时操作。

什么是 Page Visibility API？

Page Visibility API 是一个浏览器提供的 API，它可以告诉我们页面的可见性状态。当页面变为不可见时，我们可以暂停一些不必要的操作，比如动画或媒体播放。这个 API 提供了两个核心功能：

document.hidden：返回一个布尔值，指示页面当前是否隐藏。
document.visibilityState：返回页面的可见性状态，可以是 'visible'（页面可见）、'hidden'（页面隐藏）或 'prerender'（页面正在预渲染）。
visibilitychange 事件：当页面的可见性状态（document.visibilityState）改变时触发。

`visibilityState` 的作用

document.visibilityState 提供比 document.hidden 更直观的信息。它不仅告诉你页面是否隐藏，还能进一步区分页面是否正在预渲染。例如，你可以根据不同的状态采取不同的优化措施。

浏览器兼容性

虽然 Page Visibility API 很有用，但它的兼容性在不同浏览器中略有差异。以下是各主流浏览器的支持情况：

`Document.hidden` 和 `document.visibilityState`

浏览器	支持情况	版本
Chrome	支持	自 33 版本起
Firefox	支持	自 18 版本起
Safari	支持	自 7 版本起
Edge	支持	自 12 版本起
Opera	支持	自 20 版本起

`visibilitychange` 事件

浏览器	支持情况	版本
Chrome	支持	自 62 版本起
Firefox	支持	自 56 版本起
Safari	支持	自 14.1 版本起
Edge	支持	自 18 版本起
Opera	支持	自 49 版本起

用户切换标签页时暂停视频播放

当用户切换标签页时，继续播放视频会浪费带宽和资源。通过 Page Visibility API，可以在页面不可见时暂停视频，等用户返回后再自动恢复播放。

const videoElement = document.querySelector("video");document.addEventListener("visibilitychange", function() {if (document.visibilityState === 'hidden') {// 页面隐藏时暂停视频videoElement.pause();console.log("页面隐藏，视频暂停");} else if (document.visibilityState === 'visible') {// 页面可见时恢复视频播放videoElement.play();console.log("页面可见，视频继续播放");}
});

页面不可见时停止资源密集型动画

动画可能是性能瓶颈，尤其是在页面不可见时运行动画毫无意义。通过 Page Visibility API，我们可以在页面不可见时暂停动画，减少 CPU 和 GPU 的消耗。

let animationRunning = true;function startAnimation() {if (!animationRunning) return;// 假设这里有动画逻辑console.log("动画正在运行...");requestAnimationFrame(startAnimation);
}document.addEventListener("visibilitychange", function() {if (document.visibilityState === 'hidden') {// 页面隐藏时停止动画animationRunning = false;console.log("页面隐藏，动画停止");} else if (document.visibilityState === 'visible') {// 页面可见时恢复动画animationRunning = true;startAnimation();console.log("页面可见，动画恢复");}
});startAnimation();

页面不可见时停止 API 请求

某些情况下，持续的数据获取可能会浪费带宽。通过检测页面的可见性，可以在页面不可见时停止数据请求，优化带宽使用。

let requestInterval;function startFetchingData() {requestInterval = setInterval(() => {// 模拟 API 请求console.log("正在获取数据...");}, 5000);
}function stopFetchingData() {clearInterval(requestInterval);console.log("停止获取数据");
}document.addEventListener("visibilitychange", function() {if (document.visibilityState === 'hidden') {// 页面隐藏时停止数据获取stopFetchingData();} else if (document.visibilityState === 'visible') {// 页面可见时恢复数据获取startFetchingData();}
});startFetchingData();

页面可见时恢复定时操作

当页面不可见时，某些定时任务可以暂停，直到用户返回页面时再恢复执行。这有助于提升资源利用效率。

let intervalId;function startTimer() {intervalId = setInterval(() => {console.log("计时器正在运行...");}, 1000);
}function stopTimer() {clearInterval(intervalId);console.log("计时器停止");
}document.addEventListener("visibilitychange", function() {if (document.visibilityState === 'hidden') {// 页面隐藏时停止计时器stopTimer();} else if (document.visibilityState === 'visible') {// 页面可见时恢复计时器startTimer();}
});startTimer();

用户返回页面时恢复音频播放

与视频类似，音频在页面不可见时继续播放不仅对用户无意义，还会浪费系统资源。通过 Page Visibility API 可以在用户返回页面时恢复音频播放。

const audioElement = document.querySelector("audio");document.addEventListener("visibilitychange", function() {if (document.visibilityState === 'hidden') {// 页面隐藏时暂停音频audioElement.pause();console.log("页面隐藏，音频暂停");} else if (document.visibilityState === 'visible') {// 页面可见时恢复音频播放audioElement.play();console.log("页面可见，音频继续播放");}
});

结论

Page Visibility API 是一个简单但非常有效的工具，能够让开发者根据页面的可见性来动态优化资源的使用。结合 document.visibilityState，你可以进一步细化页面状态的控制，如在页面预渲染时暂停某些操作。

这种优化不仅提升了用户体验，还能显著减少系统资源的浪费。通过合理利用这个 API，我们可以暂停后台的视频、音频、动画、数据请求等操作，并在用户重新关注页面时迅速恢复，达到性能和体验的双重提升。

在开发过程中，别忘了考虑浏览器的兼容性问题，确保在所有平台上提供一致的用户体验。希望这篇文章能够帮助你更好地掌握 Page Visibility API 并将其应用到实际项目中。

参考内容

页面可见性 API - Web API | MDN (mozilla.org)
Document：visibilitychange 事件 - Web API | MDN (mozilla.org)
Document：hidden 属性 - Web API | MDN (mozilla.org)
Document.visibilityState - Web API | MDN (mozilla.org)