DIV CSS 佈局教程網

JavaScript WebSocket 入門實作:屬性、事件與方法完整說明
編輯:JavaScript基礎知識     

只要搞清楚 socket 與伺服器之間的連線是怎麼建立的,你就能從瀏覽器主動送出資料、並接收伺服器推回來的訊息。這是 WebSocket 最核心的價值:一條長連線,雙向隨時說話,不必再靠輪詢硬撐。

建立連線

var Socket = new WebSocket(url, [protocol]);

第一個參數是要連的位址,使用 ws:// 或加密的 wss://;第二個參數是選填的,用來指定伺服器有支援的子協定。

屬性

Socket.readyState 是唯讀屬性,代表目前的連線狀態,有四種取值:

  1. 0:連線尚未建立。
  2. 1:連線已建立,可以正常收發。
  3. 2:連線正在關閉的握手過程中。
  4. 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 頁面下會直接被瀏覽器攔下(混合內容政策)。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved