萬盛學電腦網

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

使用 JavaScript 偵測用戶網路連線狀態

前言

在 Web 開發中,了解用戶是否處於線上狀態,對於提供離線支援、同步資料或顯示即時通知至關重要。早期的 Internet Explorer 曾提供專屬的 clientCaps 行為來檢測連線類型,但這屬於非標準且已被淘汰的技術。現代瀏覽器提供了標準化的 Navigator.onLine 屬性以及 online/offline 事件,能更可靠地實現此需求。

現代標準作法:Navigator.onLine

navigator.onLine 會回傳一個布林值,指示瀏覽器是否認為具有網路連線。雖然它無法保證能連上特定伺服器,但足以應對大多數 UI 狀態切換場景。

// 簡單檢查
if (navigator.onLine) {
  console.log('使用者目前在線上');
} else {
  console.log('使用者目前離線');
}

監聽網路狀態變化

透過 window 物件監聽 online 和 offline 事件,即可即時回應連線狀態改變:

window.addEventListener('online', () => {
  console.log('網路已連線');
  // 例如:同步本地快取、啟用即時功能
});

window.addEventListener('offline', () => {
  console.log('網路已斷開');
  // 例如:切換至離線模式、提示用戶
});

進階:實際連線驗證

navigator.onLine 在某些情況下(如連上區域網路但無外網)會回傳 true。若需確認真正能連上互聯網,可嘗試發送輕量級請求:

async function checkRealConnectivity() {
  try {
    // 使用無模式請求避免 CORS 問題,或指向自家伺服器的健康檢查端點
    await fetch('https://www.google.com/generate_204', { method: 'HEAD', mode: 'no-cors' });
    return true;
  } catch {
    return false;
  }
}

舊版 IE 專屬寫法(僅供參考)

原文件中的 clientCaps 僅在舊版 IE(含 IE11 相容模式)下運作,現代專案不建議使用:

<!-- 僅 IE 支援 -->
<style>
  @media all {
    CAP\:clientCaps { behavior: url(#default#clientcaps) }
  }
</style>
<script for="window" event="onload">
  if (oClientCaps.connectionType === "online") {
    sType.innerText = "Internet 歡迎您!";
  } else {
    sType.innerText = "怎麼沒有上網?";
  }
</script>
<CAP:clientCaps id="oClientCaps" />
<div id="sType"></div>

最佳實踐建議

  • 優先使用 navigator.onLine + 事件監聽,覆蓋 95% 以上現代瀏覽器。
  • 結合 Service Worker 與 Cache API 實現真正的離線體驗。
  • 對關鍵業務(如支付、同步)採用「嘗試請求」作為最終驗證。
  • 提供視覺化指示器(如頂部橫幅、圖示)讓用戶知悉當前狀態。

總結

網路狀態偵測已從專屬 Hack 邁向標準化 API。善用 navigator.onLine 與 online/offline 事件,配合實際請求驗證,即可構建強健的線上/離線感知應用。

copyright © 萬盛學電腦網 all rights reserved