WebSocket
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
* Some parts of this feature may have varying levels of support.
WebSocket 对象提供了用于创建和管理 WebSocket 连接，以及可以通过该连接发送和接收数据的 API。
使用 WebSocket() 构造函数来构造一个 WebSocket。
构造函数
WebSocket(url[, protocols])-
返回一个
WebSocket对象。
常量
| Constant | Value |
|---|---|
WebSocket.CONNECTING | 0 |
WebSocket.OPEN | 1 |
WebSocket.CLOSING | 2 |
WebSocket.CLOSED | 3 |
属性
WebSocket.binaryType-
使用二进制的数据类型连接。
WebSocket.bufferedAmount只读-
未发送至服务器的字节数。
WebSocket.extensions只读-
服务器选择的扩展。
WebSocket.onclose-
用于指定连接关闭后的回调函数。
WebSocket.onerror-
用于指定连接失败后的回调函数。
WebSocket.onmessage-
用于指定当从服务器接受到信息时的回调函数。
WebSocket.onopen-
用于指定连接成功后的回调函数。
WebSocket.protocol只读-
服务器选择的下属协议。
WebSocket.readyState只读-
当前的链接状态。
WebSocket.url只读-
WebSocket 的绝对路径。
方法
WebSocket.close([code[, reason]])-
关闭当前链接。
WebSocket.send(data)-
对要传输的数据进行排队。
事件
使用 addEventListener() 或将一个事件监听器赋值给本接口的 oneventname 属性，来监听下面的事件。
示例
js
// Create WebSocket connection. const socket = new WebSocket("ws://localhost:8080"); // Connection opened socket.addEventListener("open", function (event) { socket.send("Hello Server!"); }); // Listen for messages socket.addEventListener("message", function (event) { console.log("Message from server ", event.data); }); 规范
| Specification |
|---|
| WebSockets # the-websocket-interface |