萬盛學電腦網

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

JavaScript 判斷用戶是關閉頁面還是刷新/跳轉的實現原理

核心難點

window.onunload / beforeunload 觸發時,頁面即將卸載,**無法直接區分**用戶是點擊關閉按鈕、刷新 (F5/Ctrl+R)、跳轉鏈接、提交表單、關閉標簽頁、關閉瀏覽器窗口。

傳統 Hack 方案:screenX/clientY 位置判斷 (僅限 IE/舊 Edge)

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('用戶刷新/跳轉/提交表單');
  }
};

缺陷:

  • 強依賴 IE 專有 window.event、screenLeft、clientY
  • 現代瀏覽器 (Chrome/Firefox/Edge/Safari) **完全不支持**此邏輯
  • 用戶可能用鍵盤關閉、手勢關閉、任務管理器殺進程,坐標判斷失效

現代標準方案:beforeunload + 性能導航 API

1. PerformanceNavigationTiming (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: 預渲染
  }
});

2. 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...
  }
});

3. 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 不觸發 unloadSafari/Firefox/Chrome 96+ 默認啟用監聽 pageshow 恢復狀態,pagehide persisted=true 不視為卸載
跨域 iframe 內無法捕獲父頁面導航同源策略限制父頁面通過 postMessage 通知子頁面
移動端瀏覽器可能直接殺進程無任何事件系統級資源回收關鍵數據定時自動保存 (localStorage/IndexedDB)
beforeunload 內異步請求可能被取消瀏覽器不等待異步完成用 navigator.sendBeacon() 發送統計/日誌

發送關閉統計的標準姿勢: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 刷新/跳轉」的本質是**捕獲用戶導航意圖**。現代方案組合:

  1. 捕獲意圖:click/keydown/submit/popstate → 寫入 sessionStorage + 內存變量
  2. 讀取意圖:beforeunload / pagehide (排除 persisted) 讀取並清理
  3. 兜底判斷:無意圖標記視為關閉類
  4. 數據上報:navigator.sendBeacon() 保證送達
  5. 業務處理:保存草稿、斷開連接、清理資源、統計上報

這套機制在主流現代瀏覽器 (Chrome 60+, Firefox 55+, Safari 11+, Edge 79+) 穩定可靠,是單頁應用、編輯器、長表單等場景的標配基礎設施。

copyright © 萬盛學電腦網 all rights reserved