websocket對象及方法

# websocket對象及方法

1.websocket對象

如下 API 用於建立 WebSocket 對象。

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

以上代碼中的第一個參數 url, 指定鏈接的 URL。第二個參數 protocol 是可選的，指定了可接受的子協議。

2.WebSocket 屬性

如下是 WebSocket 對象的屬性。假定咱們使用了以上代碼建立了Socket對象，它具備下列屬性：

• Socket.readyState
  只讀屬性 readyState 表示鏈接狀態，能夠是如下值：
  0 - 表示鏈接還沒有創建。
  1 - 表示鏈接已創建，能夠進行通訊。
  2 - 表示鏈接正在進行關閉。
  3 - 表示鏈接已經關閉或者鏈接不能打開。
• Socket.bufferedAmount
  只讀屬性 bufferedAmount 已被 send() 放入正在隊列中等待傳輸，可是尚未發出的 UTF-8 文本字節數。

3.WebSocket 事件

如下是 WebSocket 對象的相關事件。假定咱們使用了以上代碼建立了 Socket 對象：

事件	事件處理程序	描述
open	Socket.onopen	鏈接創建時觸發
message	Socket.onmessage	客戶端接收服務端數據時觸發
error	Socket.onerror	通訊發生錯誤時觸發
close	Socket.onclose	鏈接關閉時觸發

4.WebSocket 方法

如下是 WebSocket 對象的相關方法。假定咱們使用了以上代碼建立了 Socket 對象：

Socket.send() # 使用鏈接發送數據
Socket.close() # 關閉鏈接