頁面關閉流程涉及多個事件,行為差異大。本文詳細對比 beforeunload、unload、pagehide、visibilitychange,實現「檢測用戶取消關閉」的可靠方案,並解決埋點數據發送可靠性問題(navigator.sendBeacon、fetch keepalive)。
| 事件 | 觸發時機 | 可阻止關閉 | 異步操作 | 移動端支援 | 推薦用途 |
|---|---|---|---|---|---|
beforeunload | 用戶關閉標籤/刷新/跳轉前 | 是(返回字符串) | **不可靠**(瀏覽器可能終止) | 部分支援 | 提示未保存更改 |
unload | 文件開始卸載 | 否 | **不可靠**(同步代碼のみ) | 不可靠 | **不推薦使用** |
pagehide | 頁面隱藏/卸載(bfcache 恢復時不觸發) | 否 | **可靠**(配合 persisted) | 良好 | 頁面生命周期管理、清理資源 |
visibilitychange | document.visibilityState 變化 | 否 | 可靠 | 良好 | 頁面可見性切換、暫停視頻/動畫 |
beforeunload 無法直接得知用戶選擇。利用 **定時器延遲** 技巧:
let cancelDetected = false;
let timerId;
window.addEventListener('beforeunload', e => {
e.preventDefault();
e.returnValue = ''; // 標準寫法,部分瀏覽器需返回字符串
// 啟動檢測定時器
timerId = setTimeout(() => {
cancelDetected = true;
onCancelClose(); // 用戶點擊「取消」或頁面未真正關閉
}, 50); // 50ms 足夠區分
});
function onCancelClose() {
console.log('用戶取消關閉或頁面存活');
// 恢復狀態、重新啟動心跳、取消離開確認彈窗殘留狀態
}
// 頁面真正卸載時清理
window.addEventListener('pagehide', e => {
clearTimeout(timerId);
if (!cancelDetected && !e.persisted) {
onConfirmClose(); // 用戶確認離開
}
});
function onConfirmClose() {
// 發送最終埋點、清理 WebSocket、釋放鎖
navigator.sendBeacon('/analytics/leave', JSON.stringify({ sessionId }));
}
// 最佳:sendBeacon(異步、不阻塞卸載、瀏覽器保證發送)
navigator.sendBeacon('/analytics/event', JSON.stringify({ event: 'purchase', value: 100 }));
// 兼容:fetch keepalive
fetch('/analytics/event', {
method: 'POST',
body: JSON.stringify({ event: 'purchase' }),
keepalive: true, // 關鍵:頁面卸載後仍發送
headers: { 'Content-Type': 'application/json' }
});
// 統一生命周期管理器
class PageLifecycle {
constructor() {
this.hidden = document.hidden;
this._bind();
}
_bind() {
document.addEventListener('visibilitychange', () => {
this.hidden = document.hidden;
this.hidden ? this._onHide() : this._onShow();
});
window.addEventListener('pagehide', e => this._onPageHide(e));
window.addEventListener('beforeunload', e => this._onBeforeUnload(e));
}
_onShow() { console.log('頁面可見'); resumeAnimations(); reconnectWebSocket(); }
_onHide() { console.log('頁面隱藏'); pauseAnimations(); }
_onPageHide(e) { if (!e.persisted) cleanup(); } // 真正卸載
_onBeforeUnload(e) { if (hasUnsavedChanges) { e.preventDefault(); e.returnValue = ''; } }
}
new PageLifecycle();
現代瀏覽器將頁面存入 bfcache,pagehide 的 persisted=true 表示頁面可能被恢復,**不執行清理邏輯**。pageshow 事件對應恢復。