只要搞清楚 socket 與伺服器之間的連線是怎麼建立的,你就能從瀏覽器主動送出資料、並接收伺服器推回來的訊息。這是 WebSocket 最核心的價值:一條長連線,雙向隨時說話,不必再靠輪詢硬撐。
var Socket = new WebSocket(url, [protocol]);
第一個參數是要連的位址,使用 ws:// 或加密的 wss://;第二個參數是選填的,用來指定伺服器有支援的子協定。
Socket.readyState 是唯讀屬性,代表目前的連線狀態,有四種取值:
0:連線尚未建立。1:連線已建立,可以正常收發。2:連線正在關閉的握手過程中。3:連線已關閉,或無法開啟。Socket.bufferedAmount 表示已經呼叫 send() 但還沒真正送出去的位元組數。這個值一直居高不下,通常代表網路寫不動了,可以拿來做流量控制。
Socket.onopen:連線建立完成時觸發。Socket.onmessage:收到伺服器資料時觸發,內容在 event.data。Socket.onerror:發生通訊錯誤時觸發。Socket.onclose:連線關閉時觸發。Socket.send(data):透過已建立的連線傳送資料。Socket.close():主動關閉連線。<!DOCTYPE html>
<html>
<head>
<script type="text/javascript">
function WebSocketTest() {
if ("WebSocket" in window) {
alert("你的瀏覽器支援 WebSocket");
var ws = new WebSocket("ws://localhost:9998/echo");
ws.onopen = function() {
// 連線已建立,用 send() 送資料
ws.send("要傳送的訊息");
alert("訊息已送出");
};
ws.onmessage = function(evt) {
var received_msg = evt.data;
alert("收到訊息:" + received_msg);
};
ws.onclose = function() {
alert("連線已關閉");
};
} else {
alert("你的瀏覽器不支援 WebSocket");
}
}
</script>
</head>
<body>
<div id="sse">
<a href="javascript:WebSocketTest()">執行 WebSocket 測試</a>
</div>
</body>
</html>
重連。onclose 之後應該做退避重試,而不是就這樣放著,否則行動網路上一斷線就再也回不來。
心跳。長時間閒置的連線可能被中間設備判定為失效而切斷,定期送一個 ping 訊息可以保活。
錯誤訊息拿不到細節。出於安全考量,onerror 事件通常不會告訴你具體原因,別指望從中除錯,要搭配伺服器端日誌一起看。
務必用 wss。正式環境請全程走加密協定,明文 ws 在 HTTPS 頁面下會直接被瀏覽器攔下(混合內容政策)。