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() # 关闭链接