WebSocket是JavaScript实现实时通信最常用方式，基于单个TCP连接实现全双工、低延迟双向通信；需监听onopen、onmessage、onerror、onclose事件，用JSON收发结构化数据，并手动实现带重试限制的自动重连，注意wss://与HTTPS匹配及跨域服务端校验。
JavaScript 实现实时通信，最常用、最直接的方式就是使用 WebSocket。它是一种在单个 TCP 连接上进行全双工通信的协议，能让浏览器与服务器之间建立持久连接，实现低延迟、双向、实时的数据交换。
WebSocket 的基本使用流程
创建 WebSocket 连接非常简单，核心是实例化 WebSocket 对象，并监听关键事件：
-
连接建立：监听
onopen，连接成功后可立即发送数据 -
接收消息：监听
onmessage，服务端推送的数据会在这里触发 -
连接异常：监听
onerror，处理网络中断或协议错误 -
连接关闭：监听
onclose，可在此做清理或重连逻辑
示例代码：
const ws = new WebSocket('wss://example.com/chat');
ws.onopen = () => {
console.log('已连接');
ws.send(JSON.stringify({ type: 'join', user: 'Alice' }));
};
ws.onmessage = (event) => {
const data = JSON.parse(event.data);
console.log('收到消息：', data);
};
ws.onerror = (error) => {
console.error('WebSocket 错误：', error);
};
ws.onclose = () => {
console.log('连接已关闭');
};
发送与接收结构化数据
WebSocket 本身只收发字符串或 ArrayBuffer，实际项目中建议统一用 JSON 格式通信，便于前后端解析：
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
立即学习“Java免费学习笔记（深入）”；
- 发送前用
JSON.stringify()序列化对象 - 接收后用
JSON.parse()解析字符串 - 可在消息体中加入
type字段区分业务类型（如'message'、'typing'、'online-list'）
处理断线与自动重连
WebSocket 并不自带重连机制，需手动实现。常见做法是：
- 在
onclose或onerror中设置延时重试（避免频繁请求） - 限制最大重试次数，防止无限循环
- 每次重连前检查
ws.readyState，避免重复连接（0=CONNECTING,1=OPEN,2=CLOSING,3=CLOSED）
注意同源与安全限制
WebSocket 协议不受同源策略限制，但浏览器仍要求页面协议与 WebSocket 协议匹配：
- HTTP 页面只能连接
ws://（开发环境可临时使用，生产不推荐） - HTTPS 页面必须连接
wss://（加密 WebSocket，等价于 HTTPS 之于 HTTP） - 若后端 WebSocket 服务部署在不同域名或端口，需确保服务端设置了正确的跨域响应头（如
Sec-WebSocket-Origin已废弃，现代浏览器主要依赖服务端校验 Origin）
