隨著移動端佔比超過桌面端,根據用戶網絡環境(WiFi/2G/3G/4G/5G)動態調整資源加載策略(圖片質量、視頻碼率、預加載開關)成為性能優化關鍵。navigator.connection (Network Information API) 提供了這一能力。
type (effective connection type)、downlink (Mbps)、rtt (ms)、saveData (省流模式)。type (connection type: wifi/cellular/ethernet/none)、bandwidth (Mbps)、metered (流量計費)。change 監聽網絡變化。| 瀏覽器 | 支持 | 備註 |
|---|---|---|
| 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 返回值 | 類型 |
|---|---|---|
| 0 | UNKNOWN | 未知 |
| 1 | ETHERNET | 以太網 |
| 2 | WIFI | WiFi |
| 3 | CELL_2G | 2G |
| 4 | CELL_3G | 3G |
| 5 | CELL_4G | 4G (含 HSPA+) |
Firefox 實現新標準但數值固定:WiFi/3G 返回 downlink=20,2G 返回 0.1953125,不反映實時帶寬。建議僅作參考,結合實際測速。
// 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. 用戶手動選擇「省流模式」開關
change 事件可能高頻觸發,防抖 1-2 秒後再調整策略。Network Information API 為自適應加載提供了標準化接口,雖然 Safari 缺位、數值準確性有限,但在 Android/Chrome 生態中極具價值。結合降級測速、用戶偏好、業務場景,構建完整的網絡適配體系。