For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /blog/mobile/page-visibility.md.

页面可见性监听

1、业务需求：

PC 端直播，为了统计用户观看的有效时长，对观看直播的规则做了一些要求，目的是为了提高用户的有效观看时长。

具体要求如下：

  1. 浏览器页面最小化时，暂停播放，停止计时；
  2. 浏览器页面恢复时，视频继续播放，计时从零开始；
  3. 刷新浏览器页面时，重新计时；

2、页面显示与隐藏

使用的是浏览器的 visibilityState 属性：

页面显示与隐藏
// 页面的显示与隐藏
const pageShowOrHide = function (e) {
    let stv = e.target.visibilityState || document.visibilityState;
    if (stv === "hidden") {
        // 用户最小化了页面 or 切到了别的页面
        /* 处理页面隐藏事件代码 */
    } else if (stv === "visible") {
        // 用户回到了页面
        /* 处理页面恢复事件代码 */
    }
};

绑定&解除事件函数

事件监听
// 绑定事件函数
window.addEventListener(
    "visibilitychange",
    function () {
        pageShowOrHide();
    },
    false
);

window.addEventListener("visibilitychange", pageShowOrHide());

// 解除事件函数
window.removeEventListener(
    "visibilitychange",
    function () {
        pageShowOrHide();
    },
    false
);

window.removeEventListener("visibilitychange", pageShowOrHide());

false：是否冒泡

3、刷新页面（页面卸载）

刷新页面
window.addEventListener(
    "beforeunload",
    function () {
        /* 执行页面卸载前的事件代码 */
    },
    false
);

window.removeEventListener("beforeunload", function () {}, false);

// or
window.addEventListener("beforeunload", function () {
    /* 执行页面卸载前的事件代码 */
});

window.removeEventListener("beforeunload", function () {});