大网数据广告活动
Web 标准与前端开发

WebSocket

· 52CE 我爱测

`WebSocket` 对象提供了用于创建和管理与服务器的 WebSocket 连接,以及可以通过该连接发送和接收数据的 API。

WebSockets API

WebSocket 对象提供了用于创建和管理与服务器的 WebSocket 连接,以及可以通过该连接发送和接收数据的 API。

使用 WebSocket() 构造函数来构造 WebSocket。

[!NOTE] WebSocket API 无法应用背压,因此当消息到达速度超过应用程序的处理速度时,应用程序要么因缓冲这些消息而耗尽设备内存,要么因 100% CPU 使用率而变得无响应,甚至可能同时出现这两种情况。如需一种能提供自动背压的替代方案,请参见 WebSocketStream。

构造函数

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

实例属性

  • WebSocket.binaryType
    • : 由连接所使用的二进制数据类型。
  • WebSocket.bufferedAmount
    • : 队列中数据的字节数。
  • WebSocket.extensions
    • : 服务器选择的扩展。
  • WebSocket.protocol
    • : 服务器选择的子协议。
  • WebSocket.readyState
    • : 连接的当前状态。
  • WebSocket.url
    • : WebSocket 的绝对 URL。

实例方法

  • WebSocket.close()
    • : 关闭连接。
  • WebSocket.send()
    • : 将待传输的数据加入队列。

事件

使用 addEventListener() 或将事件监听器赋值给此接口的 oneventname 属性,来监听下面的事件。

  • WebSocket/close_event
    • : 当 WebSocket 连接被关闭时触发。也可以通过 onclose 属性使用。
  • WebSocket/error_event
    • : 当 WebSocket 连接因错误(例如无法发送数据)而关闭时触发。也可以通过 onerror 属性使用。
  • WebSocket/message_event
    • : 当通过 WebSocket 收到数据时触发。也可以通过 onmessage 属性使用。
  • WebSocket/open_event
    • : 当 WebSocket 连接成功时触发。也可以通过 onopen 属性使用。

示例

// 创建 WebSocket 连接。
const socket = new WebSocket("ws://localhost:8080");

// 连接打开
socket.addEventListener("open", (event) => {
  socket.send("你好,服务器!");
});

// 监听消息
socket.addEventListener("message", (event) => {
  console.log("来自服务器的消息:", event.data);
});

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。