萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

頁面卸載事件全解析:beforeunload/unload/pagehide/visibilitychange、檢測用戶取消關閉、可靠發送埋點數據

頁面關閉流程涉及多個事件,行為差異大。本文詳細對比 beforeunload、unload、pagehide、visibilitychange,實現「檢測用戶取消關閉」的可靠方案,並解決埋點數據發送可靠性問題(navigator.sendBeacon、fetch keepalive)。

事件時序與差異

事件觸發時機可阻止關閉異步操作移動端支援推薦用途
beforeunload用戶關閉標籤/刷新/跳轉前是(返回字符串)**不可靠**(瀏覽器可能終止)部分支援提示未保存更改
unload文件開始卸載否**不可靠**(同步代碼のみ)不可靠**不推薦使用**
pagehide頁面隱藏/卸載(bfcache 恢復時不觸發)否**可靠**(配合 persisted)良好頁面生命周期管理、清理資源
visibilitychangedocument.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 / fetch keepalive

// 最佳: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 (Back/Forward Cache) 影響

現代瀏覽器將頁面存入 bfcache,pagehide 的 persisted=true 表示頁面可能被恢復,**不執行清理邏輯**。pageshow 事件對應恢復。

copyright © 萬盛學電腦網 all rights reserved