浏览器与 Web API / 系统课时

页面可见性与生命周期事件

页面可见性与生命周期事件

本课解决页面在“加载完成、切到后台、准备离开、进入历史缓存”时如何执行正确逻辑的问题。你将学会为 load、beforeunload、visibilitychange 和 pagehide 分配职责,并实现可靠的草稿保存。

学习目标

  • 判断四类生命周期事件各自适合处理什么任务。
  • 在页面隐藏或离开时保存必要状态。
  • 避免滥用离开确认和不可靠的卸载逻辑。

先按职责选择事件

load 在文档及其依赖资源完成加载后触发,适合依赖图片尺寸、字体或完整资源状态的初始化;如果只需要访问 DOM,通常应更早使用 DOMContentLoaded 或把脚本放在文档末尾。

visibilitychange 在页面变为 visible 或 hidden 时触发。用户切换标签页、最小化窗口或进入其他应用时,页面通常会进入 hidden,这是暂停动画、记录进度和保存草稿的重要时机。

beforeunload 只应在确有未保存修改时用于离开确认。浏览器显示的是统一提示文案,自定义字符串通常不会展示,而且移动端或异常终止场景不保证触发。

pagehide 在页面被隐藏或离开会话历史时触发,并通过 event.persisted 表示页面是否可能进入往返缓存。它比传统 unload 更适合做轻量收尾,但仍不应承担耗时任务。

事件 主要时机 推荐任务 关键限制
load 页面资源加载完成 依赖资源的初始化 触发较晚
visibilitychange 可见状态改变 暂停、保存、统计 读取 document.visibilityState
beforeunload 用户准备离开 未保存内容确认 不保证触发,提示文案不可控
pagehide 页面隐藏或离开 轻量保存、状态收尾 注意 event.persisted

页面可见性与生命周期事件时间线

主示例:按页面状态保存草稿

下面的页面把草稿写入 localStorage。只有内容变脏时才动态注册 beforeunload,保存成功后立即移除监听,避免页面长期携带不必要的离开确认。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>页面生命周期示例</title>
</head>
<body>
  <label for="draft">草稿</label>
  <textarea id="draft" rows="8" cols="50"></textarea>
  <p id="status">等待输入</p>

  <script>
    const STORAGE_KEY = 'lesson-draft';
    const draft = document.querySelector('#draft');
    const status = document.querySelector('#status');
    let dirty = false;

    function beforeUnloadHandler(event) {
      // 只有存在未保存修改时才请求浏览器显示统一确认提示。
      event.preventDefault();
      event.returnValue = '';
    }

    function setDirty(value) {
      dirty = value;
      const method = value ? 'addEventListener' : 'removeEventListener';
      window[method]('beforeunload', beforeUnloadHandler);
    }

    function saveDraft(reason) {
      localStorage.setItem(STORAGE_KEY, draft.value);
      setDirty(false);
      status.textContent = `已保存:${reason}`;
    }

    window.addEventListener('load', () => {
      draft.value = localStorage.getItem(STORAGE_KEY) ?? '';
      status.textContent = '草稿已恢复';
    });

    draft.addEventListener('input', () => {
      setDirty(true);
      status.textContent = '有未保存更改';
    });

    document.addEventListener('visibilitychange', () => {
      if (document.visibilityState === 'hidden' && dirty) {
        saveDraft('visibilitychange');
      }
    });

    window.addEventListener('pagehide', (event) => {
      if (dirty) {
        const reason = event.persisted ? 'pagehide-bfcache' : 'pagehide';
        saveDraft(reason);
      }
    });
  </script>
</body>
</html>

预期结果

text
页面加载后恢复本地草稿;输入内容时状态变为“有未保存更改”。
切换到其他标签页后自动保存;若在仍为未保存状态时直接离开,浏览器可能显示统一离开确认。

可靠性与性能边界

页面进入后台后,计时器可能被限速,进程也可能被系统终止,因此关键状态应尽早保存,不要只把逻辑放在 beforeunload。网络统计或少量日志可考虑 navigator.sendBeacon(),但发送仍应保持数据量小并允许失败。

pagehide 的 persisted 为 true 时,页面可能被放入往返缓存,之后可通过浏览器前进或后退快速恢复。此时不要做不可逆的全局销毁;恢复界面时可配合 pageshow 检查缓存返回状态。

避免监听 unload 执行业务保存。它在现代浏览器中不可靠,还可能影响页面缓存策略。生命周期代码应设计成幂等操作,即同一份草稿被 visibilitychange 和 pagehide 连续保存也不会产生错误。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

页面可见性与生命周期事件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通