萬盛學電腦網

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

JavaScript 捕獲瀏覽器關閉/重整事件:區分關閉、重整、跳轉的實戰策略

核心難點

onbeforeunload 與 onunload 在「關閉分頁/瀏覽器」、「重整頁面」、「點擊連結跳轉」、「表單提交」等情況下**全部觸發**,瀏覽器**不提供原生 API 區分**這些行為。

方案一:座標判斷法 (僅 IE/舊 Edge 支援,現代瀏覽器失效)

window.onbeforeunload = function(e) {
    e = e || window.event;
    // 點擊右上角關閉按鈕:clientX > body.clientWidth 且 clientY < 0
    // Alt+F4:event.altKey === true
    if ((e.clientX > document.body.clientWidth && e.clientY < 0) || e.altKey) {
        // 執行關閉邏輯 (同步 AJAX、清除 Session)
        sendLogoutRequest();
    } else {
        // 其餘視為重整/跳轉
    }
};

缺點:Chrome/Firefox/Safari/Edge 現代版本 clientX/clientY 在 beforeunload 中皆為 0 或不可靠,**不可用於生產環境**。

方案二:標記變數法 (區分「主動跳轉」vs「關閉/重整」)

var isNavigating = false;

// 所有  點擊、表單提交、按鈕跳轉 統一標記
$(document).on('click', 'a[href], button[data-navigate], input[type="submit"]', function() {
    isNavigating = true;
});
// 表單提交
$('form').submit(function() { isNavigating = true; });

window.onbeforeunload = function() {
    if (!isNavigating) {
        // 使用者關閉分頁/瀏覽器、或重整 (F5/Ctrl+R)
        // 這裡只能做同步操作:navigator.sendBeacon、同步 XHR、localStorage 寫入
        navigator.sendBeacon('/api/logout', JSON.stringify({userId: currentUserId}));
    }
    // 重置標記 (若只是重整,頁面會重載變數歸零;若跳轉則新頁面重新初始化)
};

方案三:onbeforeunload + onunload 雙事件協作 (舊文獻常見)

<body onbeforeunload="return confirmClose()" onunload="handleUnload()">

<script>
var allowUnload = false;

function confirmClose() {
    if (!allowUnload) return "確定要離開嗎?未儲存資料將遺失。";
}

function handleUnload() {
    allowUnload = true; // 使用者確認離開後觸發 onunload
    // 這裡執行清理邏輯 (同步)
}
</script>

缺點:onbeforeunload 回傳字串會彈出瀏覽器原生確認對話框 (現代瀏覽器忽略自訂文字),使用者可選擇「留下」取消離開,但無法區分關閉/重整。

方案四:現代最佳實踐 — Beacon API + 頁面生命週期

// 1. 頁面卸載前發送登出/心跳 (非阻塞、可靠、不延遲卸載)
window.addEventListener('pagehide', function(e) {
    if (e.persisted) {
        // 頁面被瀏覽器快取 (bfcache),非真正卸載
        return;
    }
    // 真正卸載 (關閉、重整、跳轉)
    navigator.sendBeacon('/api/heartbeat/stop', JSON.stringify({sessionId: getSessionId()}));
});

// 2. 頁面可見性變化 (切換分頁、最小化)
document.addEventListener('visibilitychange', function() {
    if (document.visibilityState === 'hidden') {
        // 使用者切走,發送心跳維持在線
        navigator.sendBeacon('/api/heartbeat', JSON.stringify({sessionId: getSessionId()}));
    } else {
        // 切回,恢復即時連線 (WebSocket/SSE)
        reconnectRealtime();
    }
});

// 3. beforeunload 僅用於「未儲存資料提醒」
window.addEventListener('beforeunload', function(e) {
    if (hasUnsavedChanges()) {
        e.preventDefault();
        e.returnValue = ''; // 觸發瀏覽器預設提示
    }
});

後端配合:Session/在線狀態管理

  • 前端定時心跳 (每 30 秒 sendBeacon) 更新 Redis last_active 時間戳。
  • 後端定時掃描:last_active > 2 分鐘 視為離線,清理 Session、釋放資源、通知其他裝置。
  • 不依賴「關閉事件」判斷下線,**心跳機制才是正解**。

總結

  1. 無法可靠區分關閉 vs 重整,放棄此執念。
  2. 改用 心跳機制 (Beacon API + visibilitychange) 維持在線狀態。
  3. beforeunload 僅用於「未儲存資料提醒」。
  4. pagehide (persisted:false) 執行最終清理 (sendBeacon)。
  5. 同步 XHR 在 unload 已被瀏覽器限制/阻斷,**必須用 sendBeacon**。
copyright © 萬盛學電腦網 all rights reserved