頁面卸載前後的兩個關鍵事件——onbeforeunload(可攔截)與 onunload(不可攔截,執行最終清理)——是實現「離開提示」、「保存草稿」、「發送統計信標」的基礎。本文詳細說明用法、瀏覽器差異與現代替代方案。
<script>
window.onbeforeunload = function onbeforeunload_handler(e) {
// 返回字符串(舊標準)或設置 returnValue (IE/現代標準)
var warning = "確認要離開嗎?未保存的更改將丟失。";
(e || window.event).returnValue = warning; // 現代瀏覽器顯示通用提示,不再顯示自定義文本
return warning; // 兼容老瀏覽器
};
window.onunload = function onunload_handler() {
// 頁面確定卸載時觸發,無法攔截,無法彈窗/alert(大多數瀏覽器阻止)
// 僅能執行同步、無阻塞操作:發送 Beacon、清理資源
navigator.sendBeacon('/analytics/logout', JSON.stringify({sessionId: '...'}));
console.log("頁面已卸載,執行最終清理");
};
</script>
| 特性 | onbeforeunload | onunload |
|---|---|---|
| 可取消導航 | 是 (返回值/returnValue) | 否 |
| 可執行異步操作 | 否 (同步阻塞) | 否 (瀏覽器可能終止進程) |
| 可彈窗/alert | 舊版可,現代禁用 | 禁用 |
| 典型用途 | 離開確認、表單未保存提示 | 發送統計 Beacon、釋放 WebSocket、IndexedDB 事務提交 |
| 移動端支援 | iOS Safari 不觸發 | 不可靠 |
addEventListener 替代 onxxx 屬性(可綁定多個監聽器)window.addEventListener('beforeunload', function(e) {
if (hasUnsavedChanges) {
e.preventDefault(); // 標準寫法
e.returnValue = ''; // Chrome 要求設置 returnValue
}
});
window.addEventListener('unload', function() {
// 僅同步操作
navigator.sendBeacon('/api/heartbeat/stop', '{}');
});
document.addEventListener('visibilitychange', function() {
if (document.visibilityState === 'hidden') {
// 用戶切換標籤、最小化、鎖屏、關閉標籤前均會觸發
saveDraft();
navigator.sendBeacon('/api/heartbeat', '{}');
}
});
window.addEventListener('pagehide', function(e) {
if (e.persisted) {
// 頁面被放入 bfcache (back-forward cache),非真正銷毀
} else {
// 頁面真正銷毀,等同 unload 但更可靠
}
});
fetch/axios 在 unload 中會被瀏覽器取消,**必須用 navigator.sendBeacon** 發送少量數據(≤ 64KB)。beforeunload/unload,關鍵數據必須在 visibilitychange: hidden 時保存。pageshow (persisted=true)。邏輯不能依賴 unload 必執行。綜上,**關鍵業務數據保存請依賴 visibilitychange + sendBeacon**,beforeunload 僅作桌面端「防誤關閉」輔助。