要做「即時」的網頁應用,過去幾乎只能在輪詢與各種伺服器推送技巧之間折衝,其中最知名的是 Comet。WebSocket 的出現,讓瀏覽器與伺服器之間第一次有了一條真正的、長時間保持的雙向通道。
這三者的共同問題是:每一筆即時資料都得背著 HTTP 的請求與回應標頭。那些大量重複、不必要的標頭資料造成傳輸延遲與頻寬浪費——傳送一個「股價 12.5」卻要附上數百字節的標頭,怎麼算都不划算。
要建立 WebSocket 通訊,客戶端與伺服器在初始握手時,會把 HTTP 協議「升級」為 WebSocket 協議(回應 101 Switching Protocols)。連線一旦建立成功,後續就能在全雙工模式下雙向來回傳送訊息,不必再靠 HTTP 請求一來一往。
在早期規格的網路傳輸中,每個訊息以 0x00 位元組開頭、0xFF 結尾,中間資料採 UTF-8 編碼。(後續版本改用了帶 opcode 的資料框架,以支援二進位訊息、分片與心跳控制。)
除了定義協議本身,規格也定義了給 JavaScript 使用的 WebSocket 介面:
interface WebSocket {
readonly attribute DOMString URL;
// 就緒狀態
const unsigned short CONNECTING = 0;
const unsigned short OPEN = 1;
const unsigned short CLOSING = 2;
const unsigned short CLOSED = 3;
readonly attribute unsigned short readyState;
readonly attribute unsigned short bufferedAmount;
// 事件
attribute Function onopen;
attribute Function onmessage;
attribute Function onerror;
attribute Function onclose;
boolean send(in DOMString data);
void close();
};
WebSocket implements EventTarget;
其中 ws:// 與 wss:// 分別代表一般與加密的 WebSocket 連線;若頁面本身走 HTTPS,就必須使用 wss://,否則瀏覽器會以混合內容為由阻擋。
if (window.WebSocket) {
// 支援,可以建立連線
} else {
// 不支援,需準備降級方案(例如長輪詢)
}
var url = 'ws://localhost:8080/echo';
var ws = new WebSocket(url);
WebSocket 遵循非同步的編程模型:連線開啟後,只需等待事件發生,不必主動向伺服器輪詢。三個核心事件是 open、message、close(另有 error)。
ws.onopen = function () {
console.log('連線已建立');
};
ws.onmessage = function (e) {
console.log('收到:' + e.data);
};
ws.onerror = function (e) {
console.log('連線錯誤');
};
ws.onclose = function () {
console.log('連線已關閉');
};
只有在連線處於 open 狀態時(即 onopen 之後、onclose 之前)才能送出訊息:
ws.send('Hello World');
實務上常見的錯誤就是在 onopen 之前呼叫 send,此時 readyState 仍是 CONNECTING,訊息會被丟棄。比較穩妥的寫法是先檢查 ws.readyState === WebSocket.OPEN。
把 WebSocket 與 Geolocation 放在一起,就能做出一個「位置追蹤器」:瀏覽器定時取得座標,透過 WebSocket 送到伺服器,再由伺服器轉播給其他使用者。
<!DOCTYPE html>
<html lang="zh-Hant">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>HTML5 WebSocket / Geolocation 追蹤器</title>
<link rel="stylesheet" href="styles.css">
</head>
<body onload="loadDemo()">
<h1>HTML5 WebSocket / Geolocation 追蹤器</h1>
<div>
<strong>Geolocation</strong>:
<p id="geoStatus">您的瀏覽器不支援 HTML5 Geolocation</p>
</div>
<div>
<strong>WebSocket</strong>:
<p id="socketStatus">您的瀏覽器不支援 HTML5 WebSockets</p>
</div>
<script>
var ws;
var myId = Math.floor(100000 * Math.random()); // 本次工作階段隨機 ID
var rowCount = 0;
function updateSocketStatus(message) {
document.getElementById('socketStatus').innerHTML = message;
}
function updateGeolocationStatus(message) {
document.getElementById('geoStatus').innerHTML = message;
}
function loadDemo() {
// 1. 確認支援 WebSocket
if (window.WebSocket) {
var url = 'ws://localhost:8080';
ws = new WebSocket(url);
ws.onopen = function () {
updateSocketStatus('連線已建立');
};
ws.onmessage = function (e) {
updateSocketStatus('更新位置資料:' + dataReturned(e.data));
};
ws.onclose = function () {
updateSocketStatus('連線已中斷');
};
}
// 2. 確認支援 Geolocation
var geo;
if (navigator.geolocation) {
geo = navigator.geolocation;
updateGeolocationStatus('瀏覽器支援 HTML5 Geolocation');
}
// 每 20 秒更新一次位置
geo.watchPosition(updateLocation, handleLocationError, { maximumAge: 20000 });
function updateLocation(position) {
var latitude = position.coords.latitude;
var longitude = position.coords.longitude;
var timestamp = position.timestamp;
updateGeolocationStatus('位置更新時間:' + timestamp);
var toSend = JSON.stringify([myId, latitude, longitude]);
sendMyLocation(toSend);
}
function sendMyLocation(newLocation) {
if (ws && ws.readyState === WebSocket.OPEN) {
ws.send(newLocation);
}
}
function dataReturned(locationData) {
var allData = JSON.parse(locationData);
var incomingId = allData[1];
var incomingLat = allData[2];
var incomingLng = allData[3];
var incomingRow = document.getElementById(incomingId);
if (!incomingRow) {
incomingRow = document.createElement('div');
incomingRow.setAttribute('id', incomingId);
incomingRow.userText = (incomingId == myId) ? 'Me' : 'User' + rowCount;
rowCount++;
document.body.appendChild(incomingRow);
}
incomingRow.innerHTML = incomingRow.userText +
' // Lat: ' + incomingLat + ' // Lon: ' + incomingLng;
return incomingRow.userText;
}
function handleLocationError(error) {
switch (error.code) {
case 0:
updateGeolocationStatus('取得位置資訊出錯:' + error.message);
break;
case 1:
updateGeolocationStatus('使用者已拒絕提供位置資訊。');
break;
case 2:
updateGeolocationStatus('瀏覽器無法判定您的位置:' + error.message);
break;
case 3:
updateGeolocationStatus('瀏覽器取得位置資訊逾時。');
break;
}
}
}
</script>
</body>
</html>
onclose 裡做指數退避的重連,並搭配心跳(定期送 ping/pong)偵測僵死連線。