浏览器与 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,保存成功后立即移除监听,避免页面长期携带不必要的离开确认。
<!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>预期结果
页面加载后恢复本地草稿;输入内容时状态变为“有未保存更改”。
切换到其他标签页后自动保存;若在仍为未保存状态时直接离开,浏览器可能显示统一离开确认。可靠性与性能边界
页面进入后台后,计时器可能被限速,进程也可能被系统终止,因此关键状态应尽早保存,不要只把逻辑放在 beforeunload。网络统计或少量日志可考虑 navigator.sendBeacon(),但发送仍应保持数据量小并允许失败。
pagehide 的 persisted 为 true 时,页面可能被放入往返缓存,之后可通过浏览器前进或后退快速恢复。此时不要做不可逆的全局销毁;恢复界面时可配合 pageshow 检查缓存返回状态。
避免监听 unload 执行业务保存。它在现代浏览器中不可靠,还可能影响页面缓存策略。生命周期代码应设计成幂等操作,即同一份草稿被 visibilitychange 和 pagehide 连续保存也不会产生错误。