onbeforeunload 與 onunload 在「關閉分頁/瀏覽器」、「重整頁面」、「點擊連結跳轉」、「表單提交」等情況下**全部觸發**,瀏覽器**不提供原生 API 區分**這些行為。
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 或不可靠,**不可用於生產環境**。
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}));
}
// 重置標記 (若只是重整,頁面會重載變數歸零;若跳轉則新頁面重新初始化)
};
<body onbeforeunload="return confirmClose()" onunload="handleUnload()">
<script>
var allowUnload = false;
function confirmClose() {
if (!allowUnload) return "確定要離開嗎?未儲存資料將遺失。";
}
function handleUnload() {
allowUnload = true; // 使用者確認離開後觸發 onunload
// 這裡執行清理邏輯 (同步)
}
</script>
缺點:onbeforeunload 回傳字串會彈出瀏覽器原生確認對話框 (現代瀏覽器忽略自訂文字),使用者可選擇「留下」取消離開,但無法區分關閉/重整。
// 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 = ''; // 觸發瀏覽器預設提示
}
});
sendBeacon) 更新 Redis last_active 時間戳。last_active > 2 分鐘 視為離線,清理 Session、釋放資源、通知其他裝置。beforeunload 僅用於「未儲存資料提醒」。pagehide (persisted:false) 執行最終清理 (sendBeacon)。