萬盛學電腦網

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

JavaScript 檢測網絡連接類型與狀態:Network Information API 實戰指南

隨著移動端佔比超過桌面端,根據用戶網絡環境(WiFi/2G/3G/4G/5G)動態調整資源加載策略(圖片質量、視頻碼率、預加載開關)成為性能優化關鍵。navigator.connection (Network Information API) 提供了這一能力。

API 現狀與瀏覽器支持

  • 標準屬性:type (effective connection type)、downlink (Mbps)、rtt (ms)、saveData (省流模式)。
  • 舊版屬性:type (connection type: wifi/cellular/ethernet/none)、bandwidth (Mbps)、metered (流量計費)。
  • 事件:change 監聽網絡變化。

瀏覽器兼容性表(2024)

瀏覽器支持備註
Chrome 61+✅ 完整支持新舊屬性
Firefox 62+⚠️ 部分需啟用標誌,僅支持 downlink/rtt/saveData
Edge 79+✅ 完整Chromium 內核
Safari❌ 不支持WebKit 未實現
移動端 WebView✅ 完整Android 系統級支持較好

核心代碼:網絡類型檢測與適配

function getNetworkInfo() {
  const conn = navigator.connection || navigator.mozConnection || navigator.webkitConnection;
  if (!conn) return { type: 'unknown', downlink: null, rtt: null, saveData: false };
  
  return {
    // 新標準屬性
    effectiveType: conn.effectiveType, // 'slow-2g' | '2g' | '3g' | '4g'
    downlink: conn.downlink,           // 下行帶寬估算 Mbps
    rtt: conn.rtt,                     // 往返時延 ms
    saveData: conn.saveData,           // 用戶開啟省流模式
    
    // 舊版屬性(兼容舊瀏覽器/舊 WebView)
    type: conn.type,                   // 'wifi' | 'cellular' | 'ethernet' | 'none' | 'bluetooth'
    bandwidth: conn.bandwidth,         // 帶寬 Mbps (已棄用)
    metered: conn.metered              // 是否計費流量
  };
}

// 使用示例:根據網絡調整圖片質量
function loadAdaptiveImage(imgEl, baseUrl) {
  const { effectiveType, saveData } = getNetworkInfo();
  let quality = 'high';
  
  if (saveData || effectiveType === 'slow-2g' || effectiveType === '2g') {
    quality = 'low';
  } else if (effectiveType === '3g') {
    quality = 'medium';
  }
  
  imgEl.src = `${baseUrl}?q=${quality}&w=${imgEl.width}`;
}

// 監聽網絡變化
navigator.connection?.addEventListener('change', () => {
  console.log('網絡變化:', getNetworkInfo());
  // 重新評估資源加載策略
});

QQ 瀏覽器等國產瀏覽器的特殊返回值

部分國產瀏覽器基於舊標準,返回整數類型碼:

返回值QQ 返回值類型
0UNKNOWN未知
1ETHERNET以太網
2WIFIWiFi
3CELL_2G2G
4CELL_3G3G
5CELL_4G4G (含 HSPA+)

Firefox 異常行為說明

Firefox 實現新標準但數值固定:WiFi/3G 返回 downlink=20,2G 返回 0.1953125,不反映實時帶寬。建議僅作參考,結合實際測速。

降級策略:無 API 時的替代方案

// 1. 基於資源加載時間測速
async function measureSpeed() {
  const start = performance.now();
  await fetch('/tiny.png', { cache: 'no-store' });
  const duration = performance.now() - start;
  return duration < 200 ? 'fast' : duration < 1000 ? 'medium' : 'slow';
}

// 2. Service Worker 緩存策略適配
// 3. 用戶手動選擇「省流模式」開關

最佳實踐總結

  1. 漸進增強:API 可用時適配,不可用時默認高質量/用戶手動選擇。
  2. 防抖處理:change 事件可能高頻觸發,防抖 1-2 秒後再調整策略。
  3. 隱私合規:網絡信息屬隱私數據,需在隱私政策說明,避免濫用。
  4. 結合實測:API 提供估算值,關鍵業務(視頻會議、大文件下載)應結合實際測速。

總結

Network Information API 為自適應加載提供了標準化接口,雖然 Safari 缺位、數值準確性有限,但在 Android/Chrome 生態中極具價值。結合降級測速、用戶偏好、業務場景,構建完整的網絡適配體系。

copyright © 萬盛學電腦網 all rights reserved