單頁應用在弱網環境下經常出現「他以為按了、其實請求沒送出去」的尷尬情況。若能主動監測網路是否連線、速度落在哪個檔位,就能提前提示使用者,或自動進入離線模式。下面這個 network 物件把兩件事都包好了:連線狀態輪詢與實際下載測速。
1. 連線狀態用 navigator.onLine 判斷,這是瀏覽器原生提供的布林值。
2. 網速則靠實測:動態建立一個 img,指向一個小圖檔並附時間戳避免快取,從 onload 的耗時推算速度。耗時超過 200ms 視為過慢、100ms 以上為中等、以下為極佳。
3. 斷線後自動重連偵測。斷線時啟動一個輪詢,若恢復連線就重新開始測速,否則再等下一輪。
(function(){
var network = function(){
var monitor = this;
/** 測速計時器 */
var speedInterval = null;
/** 連線狀態計時器 */
var networkInterval = null;
/** 重連偵測計時器 */
var reNetworkInterval = null;
var time = 5000; // 輪詢間隔(毫秒)
// 取得網路連線狀態
var getConnectState = function(){
return navigator.onLine ? 1 : 0;
};
// 網路中斷
var disconnect = function(){
console.log("網路中斷");
window.clearInterval(reNetworkInterval);
reNetworkInterval = null;
endSpeed();
endNetwork();
// 延遲一輪後開始偵測是否恢復
window.setTimeout(function(){
reNetworkInterval = window.setInterval(function(){
if (getConnectState() == 1) {
window.clearInterval(reNetworkInterval);
reNetworkInterval = null;
startSpeed();
startNetwork();
} else {
window.clearInterval(reNetworkInterval);
reNetworkInterval = null;
disconnect();
}
}, time);
}, 2 * time);
};
// 網速分級處理
var speed = {
bad: function(){
console.log("網速過慢");
window.setTimeout(function(){
if (getConnectState() == 1) {
window.clearInterval(networkInterval);
networkInterval = null;
startSpeed();
} else {
disconnect();
}
}, 2 * time);
},
medium: function(){ console.log("網速中等"); },
great: function(){ console.log("網速極佳"); }
};
// 開始速度監測
var startSpeed = function(){
window.clearInterval(speedInterval);
speedInterval = null;
if (getConnectState() == 1) {
speedInterval = window.setInterval(function(){
var start = new Date().getTime();
if (getConnectState() == 1) {
var img = document.getElementById("networkSpeedImage");
if (!img) {
img = document.createElement("IMG");
img.id = "networkSpeedImage";
img.style.display = "none";
document.body.appendChild(img);
}
try {
// 加上時間戳避免命中快取,確保每次都真的走網路
img.src = "https://www.baidu.com/img/baidu_jgylogo3.gif?_t=" + new Date().getTime();
img.onload = function(){
var delta = new Date().getTime() - start;
if (delta > 200) { speed.bad(); }
else if (delta > 100) { speed.medium(); }
else { speed.great(); }
};
img.onerror = function(){ speed.bad(); };
} catch(e) {
speed.bad();
}
} else {
disconnect();
}
}, time);
} else {
disconnect();
}
};
// 停止速度監測
var endSpeed = function(){
window.clearInterval(speedInterval);
speedInterval = null;
};
// 開始連線狀態監測
var startNetwork = function(){
if (getConnectState() == 1) {
networkInterval = window.setInterval(function(){
if (getConnectState() == 0) { disconnect(); }
}, time);
} else {
disconnect();
}
};
// 停止連線狀態監測
var endNetwork = function(){
window.clearInterval(networkInterval);
networkInterval = null;
};
// 對外介面
this.start = function(){ startNetwork(); startSpeed(); };
this.stop = function(){ endSpeed(); endNetwork(); };
};
window.network = new network();
}).call(this);
// 使用時只需:
// network.start();
1. navigator.onLine 只保證「有網路介面」,不保證「能連上網際網路」。連上咖啡廳的 Wi-Fi 但沒有登入認證頁面時,onLine 依然是 true。因此務必搭配實際請求的成敗來判斷,不能只信這個值。
2. 更好的做法是監聽 online / offline 事件。瀏覽器會在狀態變化時主動觸發,比每 5 秒輪詢一次即時且不耗資源:
window.addEventListener('offline', function(){ console.log('已離線'); });
window.addEventListener('online', function(){ console.log('已恢復'); });
3. 測速用的圖片網址要換成自己伺服器上的資源。依賴第三方站點有兩個問題:對方可能改版或封鎖,而且跨境延遲會讓所有使用者都被判定為「網速過慢」。
4. img.onload 有潛在錯配風險。若前一輪下載尚未完成就啟動下一輪,onload 可能被後一輪覆蓋。實務上應在每次設定 src 前先清掉舊的 onload,或改用 fetch 搭配 AbortController 明確取消。
5. 測速輪詢會持續產生流量。行動裝置使用者對此敏感,建議把 time 調長,或在頁面不可見時(document.hidden)暫停監測。
6. 别忘了在 stop() 之外,也要處理頁面卸載時的清理,避免計時器殘留。