WebSocket

构造函数

WebSocket()

返回一个新创建的 WebSocket 对象。

实例属性

WebSocket.binaryType

连接使用的二进制数据类型。

WebSocket.bufferedAmount 只读

已排队数据的字节数。

WebSocket.extensions 只读

服务器选择的扩展。

WebSocket.protocol 只读

服务器选择的子协议。

WebSocket.readyState 只读

连接的当前状态。

WebSocket.url 只读

WebSocket 的绝对 URL。

实例方法

WebSocket.close()

关闭连接。

WebSocket.send()

将数据加入队列以进行传输。

事件

使用 addEventListener() 或通过将事件监听器分配给此接口的 oneventname 属性来监听这些事件。

close

当与 WebSocket 的连接关闭时触发。也可通过 onclose 属性访问。

error

当与 WebSocket 的连接因错误而关闭时触发，例如发送某些数据失败。也可通过 onerror 属性访问。

message

通过 WebSocket 接收到数据时触发。也可通过 onmessage 属性访问。

open

与 WebSocket 的连接打开时触发。也可通过 onopen 属性访问。

示例

// Create WebSocket connection.
const socket = new WebSocket("ws://:8080");

// Connection opened
socket.addEventListener("open", (event) => {
  socket.send("Hello Server!");
});

// Listen for messages
socket.addEventListener("message", (event) => {
  console.log("Message from server ", event.data);
});

规范

浏览器兼容性

另见

• 编写 WebSocket 客户端应用程序