萬盛學電腦網

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

JavaScript 瀏覽器關閉/刷新事件:onbeforeunload 與 onunload 完整指南

頁面卸載前後的兩個關鍵事件——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>

關鍵差異對比

特性onbeforeunloadonunload
可取消導航是 (返回值/returnValue)否
可執行異步操作否 (同步阻塞)否 (瀏覽器可能終止進程)
可彈窗/alert舊版可,現代禁用禁用
典型用途離開確認、表單未保存提示發送統計 Beacon、釋放 WebSocket、IndexedDB 事務提交
移動端支援iOS Safari 不觸發不可靠

現代最佳實踐

1. 使用 addEventListener 替代 onxxx 屬性(可綁定多個監聽器)

window.addEventListener('beforeunload', function(e) {
    if (hasUnsavedChanges) {
        e.preventDefault(); // 標準寫法
        e.returnValue = ''; // Chrome 要求設置 returnValue
    }
});

window.addEventListener('unload', function() {
    // 僅同步操作
    navigator.sendBeacon('/api/heartbeat/stop', '{}');
});

2. 頁面可見性 API:更可靠的生命週期感知

document.addEventListener('visibilitychange', function() {
    if (document.visibilityState === 'hidden') {
        // 用戶切換標籤、最小化、鎖屏、關閉標籤前均會觸發
        saveDraft();
        navigator.sendBeacon('/api/heartbeat', '{}');
    }
});

3. Page Lifecycle API(Chrome 68+)

window.addEventListener('pagehide', function(e) {
    if (e.persisted) {
        // 頁面被放入 bfcache (back-forward cache),非真正銷毀
    } else {
        // 頁面真正銷毀,等同 unload 但更可靠
    }
});

常見坑與避坑指南

  • 異步失效:fetch/axios 在 unload 中會被瀏覽器取消,**必須用 navigator.sendBeacon** 發送少量數據(≤ 64KB)。
  • 移動端不觸發:iOS Safari 從不觸發 beforeunload/unload,關鍵數據必須在 visibilitychange: hidden 時保存。
  • bfcache 影響:頁面進入前進/後退緩存時不觸發 unload,再次顯示時觸發 pageshow (persisted=true)。邏輯不能依賴 unload 必執行。
  • 自定義提示文本已死:Chrome 51+、Firefox 44+、Safari 11+ 均顯示瀏覽器內置通用文案,忽略返回字符串。

綜上,**關鍵業務數據保存請依賴 visibilitychange + sendBeacon**,beforeunload 僅作桌面端「防誤關閉」輔助。

copyright © 萬盛學電腦網 all rights reserved