window.onunload / beforeunload 觸發時,頁面即將卸載,**無法直接區分**用戶是點擊關閉按鈕、刷新 (F5/Ctrl+R)、跳轉鏈接、提交表單、關閉標簽頁、關閉瀏覽器窗口。
window.onunload = function () {
// 僅 IE 支持 event 對象屬性
var x = window.event.screenX - window.screenLeft;
var y = window.event.clientY;
var width = document.documentElement.scrollWidth;
// 點擊關閉按鈕:滑鼠通常在右上角,clientY < 0 或 screenX 超過寬度
var isClose = (x > width - 20) && (y < 0 || window.event.altKey);
if (isClose) {
console.log('用戶關閉頁面/標簽/瀏覽器');
// 發送統計、清理資源...
} else {
console.log('用戶刷新/跳轉/提交表單');
}
};
缺陷:
window.event、screenLeft、clientYPerformanceNavigationTiming (Navigation Timing Level 2)// 頁面加載時檢測導航類型
window.addEventListener('load', function () {
var navEntries = performance.getEntriesByType('navigation');
if (navEntries.length) {
var nav = navEntries[0];
console.log('導航類型:', nav.type);
// navigate: 普通鏈接跳轉、地址欄輸入
// reload: 刷新 (F5、Ctrl+R、location.reload())
// back_forward: 瀏覽器前進/後退
// prerender: 預渲染
}
});
beforeunload 配合 sessionStorage 標記意圖// 1. 標記用戶主動操作:點擊鏈接、提交表單、點擊按鈕跳轉
document.addEventListener('click', function (e) {
var target = e.target.closest('a[href], button[type="submit"], input[type="submit"]');
if (target) {
sessionStorage.setItem('userNavIntent', 'navigate');
}
}, true); // 捕獲階段,確保最先執行
document.addEventListener('keydown', function (e) {
// F5 / Ctrl+R / Cmd+R
if (e.key === 'F5' || (e.ctrlKey && e.key === 'r') || (e.metaKey && e.key === 'r')) {
sessionStorage.setItem('userNavIntent', 'reload');
}
}, true);
// 2. beforeunload 讀取意圖
window.addEventListener('beforeunload', function (e) {
var intent = sessionStorage.getItem('userNavIntent');
sessionStorage.removeItem('userNavIntent'); // 清理
if (intent === 'reload') {
console.log('用戶刷新頁面');
// 發送刷新統計
} else if (intent === 'navigate') {
console.log('用戶跳轉/提交表單');
} else {
console.log('用戶關閉標簽/瀏覽器/崩潰/強制結束進程');
// 發送關閉統計、保存草稿、斷開 WebSocket...
}
});
pagehide / visibilitychange 輔助判斷 (移動端/現代瀏覽器)var pageHidden = false;
document.addEventListener('visibilitychange', function () {
pageHidden = document.hidden;
});
window.addEventListener('pagehide', function (e) {
// e.persisted 為 true 表示頁面進入 bfcache (後退緩存),非真正卸載
if (e.persisted) {
console.log('頁面進入 bfcache,非真正關閉');
return;
}
// 結合 visibilityState 判斷
if (pageHidden) {
console.log('頁面隱藏後卸載:可能是切換標簽、最小化、鎖屏後被系統回收');
} else {
console.log('頁面可見時卸載:關閉標簽/瀏覽器/刷新/跳轉');
}
});
var NavigationTracker = (function () {
var intents = {
RELOAD: 'reload',
NAVIGATE: 'navigate',
CLOSE: 'close',
UNKNOWN: 'unknown'
};
var currentIntent = intents.UNKNOWN;
var listeners = [];
// 1. 監聽用戶主動導航行為
function bindIntentEvents() {
// 鏈接/按鈕點擊
document.addEventListener('click', function (e) {
var target = e.target.closest('a[href], button, input[type="submit"], [onclick]');
if (target && !target.hasAttribute('data-no-nav')) {
setIntent(intents.NAVIGATE);
}
}, true);
// 鍵盤刷新
document.addEventListener('keydown', function (e) {
if (e.key === 'F5' || (e.ctrlKey && e.key === 'r') || (e.metaKey && e.key === 'r')) {
setIntent(intents.RELOAD);
}
}, true);
// 表單提交
document.addEventListener('submit', function (e) {
setIntent(intents.NAVIGATE);
}, true);
// history.pushState/replaceState (SPA 路由)
var origPush = history.pushState;
var origReplace = history.replaceState;
history.pushState = function () {
setIntent(intents.NAVIGATE);
return origPush.apply(history, arguments);
};
history.replaceState = function () {
setIntent(intents.NAVIGATE);
return origReplace.apply(history, arguments);
};
window.addEventListener('popstate', function () {
setIntent(intents.NAVIGATE);
});
}
function setIntent(intent) {
currentIntent = intent;
sessionStorage.setItem('navIntent', intent);
}
// 2. 註冊卸載回調
function onUnload(callback) {
listeners.push(callback);
}
function fireUnload(intent) {
listeners.forEach(function (fn) {
try { fn(intent); } catch (e) { console.error(e); }
});
}
// 3. 綁定卸載事件
window.addEventListener('beforeunload', function () {
var intent = sessionStorage.getItem('navIntent') || currentIntent;
sessionStorage.removeItem('navIntent');
fireUnload(intent);
});
window.addEventListener('pagehide', function (e) {
if (!e.persisted) {
var intent = sessionStorage.getItem('navIntent') || currentIntent;
sessionStorage.removeItem('navIntent');
fireUnload(intent);
}
});
// 初始化
bindIntentEvents();
return {
onUnload: onUnload,
getCurrentIntent: function () { return currentIntent; },
intents: intents
};
})();
// 使用
NavigationTracker.onUnload(function (intent) {
switch (intent) {
case NavigationTracker.intents.RELOAD:
track('page_reload');
break;
case NavigationTracker.intents.NAVIGATE:
track('page_navigate');
break;
case NavigationTracker.intents.CLOSE:
default:
track('page_close');
saveDraft();
disconnectWebSocket();
break;
}
});
| 限制 | 說明 | 應對 |
|---|---|---|
| 無法 100% 區分「關閉標簽」vs「關閉瀏覽器」vs「殺進程」 | 瀏覽器不暴露此信息 | 統一歸類為「關閉類」,業務邏輯一致處理 |
| bfcache (Back-Forward Cache) 導致 pagehide 不觸發 unload | Safari/Firefox/Chrome 96+ 默認啟用 | 監聽 pageshow 恢復狀態,pagehide persisted=true 不視為卸載 |
| 跨域 iframe 內無法捕獲父頁面導航 | 同源策略限制 | 父頁面通過 postMessage 通知子頁面 |
| 移動端瀏覽器可能直接殺進程無任何事件 | 系統級資源回收 | 關鍵數據定時自動保存 (localStorage/IndexedDB) |
| beforeunload 內異步請求可能被取消 | 瀏覽器不等待異步完成 | 用 navigator.sendBeacon() 發送統計/日誌 |
window.addEventListener('beforeunload', function () {
var data = JSON.stringify({
action: 'page_close',
url: location.href,
timestamp: Date.now(),
sessionId: getSessionId()
});
// 異步、非阻塞、瀏覽器保證盡力發送
navigator.sendBeacon('/api/analytics', data);
});
判斷「關閉 vs 刷新/跳轉」的本質是**捕獲用戶導航意圖**。現代方案組合:
sessionStorage + 內存變量beforeunload / pagehide (排除 persisted) 讀取並清理navigator.sendBeacon() 保證送達這套機制在主流現代瀏覽器 (Chrome 60+, Firefox 55+, Safari 11+, Edge 79+) 穩定可靠,是單頁應用、編輯器、長表單等場景的標配基礎設施。