在現代 Web 開發中，我們常常需要知道用戶是否還停留在當前頁面。這個看似簡單的需求，背后卻關聯著用戶體驗、數據分析和系統性能等多個重要方面。

“離開頁面”這個行為本身可以被細分為多種場景：

• 切換到其他瀏覽器標簽頁或應用（頁面變為不可見，但未關閉）。
• 最小化瀏覽器窗口（同上）。
• 關閉瀏覽器標簽頁或整個瀏覽器。
• 在當前標簽頁中導航到新的 URL。
• 在移動設備上切換到其他 App 或返回主屏幕。

針對這些不同的場景，前端提供了多種不同的技術和 API 來進行判斷。

方法一：Page Visibility API (頁面可見性 API) - 現代首選

這是處理“頁面是否對用戶可見”這一問題的標準方法。它專門用于檢測頁面是否被隱藏或顯示，非常適合處理用戶切換標簽頁、最小化窗口等場景。

核心概念：

• document.hidden：一個只讀屬性，如果頁面處于后臺或最小化狀態，則返回 true，否則返回 false。
• visibilitychange 事件：當頁面的可見性狀態發生變化時（即 document.hidden 的值改變時），該事件會在 document 對象上觸發。

適用場景：

• 暫停/播放視頻或音頻。
• 停止/啟動動畫或輪播圖。
• 暫停輪詢服務器請求，在頁面恢復可見時再繼續。

代碼示例：

document.addEventListener('visibilitychange', () => {
  if (document.hidden) {
    // 頁面變得不可見
    console.log('用戶離開了當前頁面（切換標簽頁或最小化）');
    // 在這里暫停視頻、動畫等
    pauseMyVideo();
  } else {
    // 頁面恢復可見
    console.log('用戶回到了當前頁面');
    // 在這里恢復播放
    playMyVideo();
  }
});

優點：

• 標準、可靠：W3C 標準，所有現代瀏覽器都支持。
• 性能友好：專門為此設計，能有效節省 CPU 和電池資源。
• 邏輯清晰：直接反映頁面的“可見”狀態。

缺點：

• 它無法判斷用戶是否正在關閉頁面。當用戶關閉標簽頁時，visibilitychange 事件可能會觸發（變為 hidden），但我們無法區分這是切換還是關閉。

方法二：beforeunload 和 unload 事件 - 傳統告別方式

這兩個事件是在用戶即將真正離開頁面（關閉、刷新、導航到其他鏈接）時觸發的。

1. beforeunload 事件

該事件在窗口、文檔及其資源即將被卸載時觸發。它可以用來詢問用戶是否確定要離開。

核心用途：防止用戶意外丟失未保存的數據。瀏覽器通常會彈出一個確認對話框。

代碼示例：

注意：出于安全考慮，現代瀏覽器不允許開發者自定義提示框中的文本內容，只會顯示瀏覽器內置的標準化提示。

2. unload 事件

該事件在頁面已經開始卸載之后觸發。這是我們在用戶離開時執行最后清理操作的傳統位置。

代碼示例：

window.addEventListener('unload', () => {
  console.log('用戶正在關閉或離開頁面');
  // 警告：在這里執行的操作可能不會完成！
  // sendAnalyticsData();
});

重大缺陷：unload 事件非常不可靠。瀏覽器在處理頁面卸載時，并不會等待 unload 事件處理器中的異步操作（如 fetch 或 XMLHttpRequest）完成。這意味著，如果我們想在這里發送一個分析數據到服務器，這個請求很可能在發送完成之前就被瀏覽器終止了。

方法三：navigator.sendBeacon() - 可靠的數據上報利器

為了解決 unload 事件中異步請求不可靠的問題，W3C 推出了 navigator.sendBeacon() API。

核心概念：sendBeacon() 方法可以異步地向服務器發送少量數據，并且瀏覽器保證會將其啟動并排隊發送，而不會阻塞或延遲頁面的卸載過程。即使頁面已經關閉，數據發送也會在后臺繼續進行。

適用場景：在用戶離開頁面時，可靠地發送日志、分析或統計數據。

如何使用（通常與 unload 或 pagehide 結合）：

這種方式是目前在頁面卸載時發送數據的最佳實踐。

方法四：pagehide 和 pageshow 事件 - 應對往返緩存（bfcache）

現代瀏覽器（尤其是移動端）引入了“往返緩存”（Back-Forward Cache, bfcache）。當用戶導航到其他頁面后，如果點擊“后退”按鈕，瀏覽器可能會直接從緩存中恢復上一個頁面，而不是重新加載它。在這種情況下，unload 事件可能根本不會觸發。

pagehide 事件則可以更好地處理這種情況。

核心概念：

• pagehide 事件：在用戶導航離開頁面時觸發，無論頁面是否被存入 bfcache。
• event.persisted：pagehide 事件對象的一個屬性。如果頁面被存入 bfcache，它為 true；否則為 false。

代碼示例：

window.addEventListener('pagehide', (event) => {
  if (event.persisted) {
    console.log('頁面正在進入 bfcache');
  } else {
    console.log('頁面正在被正常卸載');
  }

  // 無論哪種情況，這里都是發送 Beacon 的好時機
  navigator.sendBeacon('/log', getAnalyticsData());
});

pagehide 比 unload 更可靠，特別是在移動設備上。因此，推薦使用 pagehide 來代替 unload。

最終建議

• 對于“可見性”判斷：優先使用 Page Visibility API。
• 對于“離開時上報數據”：使用 navigator.sendBeacon()，并將其放在 pagehide 事件監聽器中，以獲得最佳的兼容性和可靠性。
• 對于“防止數據丟失”：僅在必要時使用 beforeunload，因為它會中斷用戶操作。
• 避免使用 unload：除非我們只需要執行一些非常簡單的同步代碼，否則盡量避免使用它，尤其不要在其中包含異步網絡請求。

通過組合運用這些現代 API，我們不僅能準確地判斷用戶的行為，還能在不犧牲性能和可靠性的前提下，打造出更智能、更友好的用戶體驗。