大网数据广告活动
Web 标准与前端开发

Window:pagehide 事件

· 52CE 我爱测

当浏览器从展示会话历史中的另一个页面过程中隐藏当前页面时,会向 Window 发送 **`pagehide`** 事件。

HTML DOM

当浏览器从展示会话历史中的另一个页面过程中隐藏当前页面时,会向 Window 发送 pagehide 事件。

例如,当用户点击浏览器的后退按钮时,在显示前一个页面之前,当前页面会接收到一个 pagehide 事件。

语法

在诸如 EventTarget.addEventListener 的方法中使用事件名,或者设置事件处理器属性。

addEventListener("pagehide", (event) => {});
onpagehide = (event) => {};

事件类型

PageTransitionEvent。从 Event 继承。

PageTransitionEvent

事件属性

  • PageTransitionEvent.persisted
    • : 指示文档是否正在从缓存中加载。

事件处理器别名

除了在 Window 接口上之外,onpagehide 事件处理器属性也在以下目标上可用:

  • HTMLBodyElement
  • HTMLFrameSetElement
  • SVGSVGElement

使用说明

与 unload 和 beforeunload 事件一样,此事件并未得到浏览器的可靠触发,特别是在移动设备上。例如,在以下场景中根本不会触发 pagehide 事件:

  1. 移动端用户访问你的网页。
  2. 用户随后切换到另一个应用程序。
  3. 后来,用户从应用管理器中关闭了浏览器。

然而,与 unload 和 beforeunload 事件不同,此事件与回退或前进缓存(bfcache)兼容,因此向此事件添加监听器不会阻止页面被纳入 bfcache 中。

表示用户会话结束的最佳事件是 visibilitychange 事件。在不支持 visibilitychange 的浏览器中,pagehide 事件是次佳的替代方案。

如果你特别想要检测页面卸载事件,pagehide 事件是最佳选项。

有关此事件如何与页面生命周期中其他事件相关的更多信息,请参阅页面生命周期 API 指南。

示例

在此示例中,建立了一个事件处理器来监听 pagehide 事件,并在页面被持久化以便重用时执行特殊处理。

window.addEventListener(
  "pagehide",
  (event) => {
    if (event.persisted) {
      /* 页面没有被丢弃,因此可以在以后重复使用 */
    }
  },
  false,
);

这里也可以通过在 Window 上的 onpagehide 事件处理器属性来编写:

window.onpagehide = (event) => {
  if (event.persisted) {
    /* 页面没有被丢弃,因此可以在以后重复使用 */
  }
};

规范

浏览器兼容性

参见

  • Window.pageshow_event 事件。
  • 页面生命周期 API 提供了在 web 应用程序中处理页面生命周期行为的最佳实践指南。
  • PageLifecycle.js:是一个 JavaScript 库,用于处理跨浏览器的页面生命周期行为不一致问题。
  • 回退或前进缓存解释了什么是回退或前进缓存,以及它对各种页面生命周期事件的影响。

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。