在 Web 開發中,了解用戶是否處於線上狀態,對於提供離線支援、同步資料或顯示即時通知至關重要。早期的 Internet Explorer 曾提供專屬的 clientCaps 行為來檢測連線類型,但這屬於非標準且已被淘汰的技術。現代瀏覽器提供了標準化的 Navigator.onLine 屬性以及 online/offline 事件,能更可靠地實現此需求。
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;
}
}
原文件中的 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% 以上現代瀏覽器。網路狀態偵測已從專屬 Hack 邁向標準化 API。善用 navigator.onLine 與 online/offline 事件,配合實際請求驗證,即可構建強健的線上/離線感知應用。