JavaScript中建立WebSocket连接需用new WebSocket(url)创建实例,正确处理onopen、onmessage、onerror、onclose事件,并在readyState为OPEN时调用send()发送数据,关闭时用close()。
JavaScript 中建立 WebSocket 连接很简单,核心就是用 new WebSocket(url) 创建实例,关键在于正确处理连接状态和错误。
只需传入 ws:// 或 wss:// 开头的服务端地址:
const ws = new WebSocket("ws://localhost:8080");(开发常用)const ws = new WebSocket("wss://api.example.com/chat");
(生产环境推荐,走加密通道)注意:协议必须匹配服务端配置,不能用 http:// 或 https://,否则会报错。
WebSocket 是事件驱动的,主要靠这四个事件控制流程:
ws.onopen:连接成功后触发,可以在这里发初始化消息ws.onmessage:收到服务器消息时触发,event.data 就是内容ws.onerror:发生网络或协议错误时触发(比如跨域、地址不可达)ws.onclose:连接关闭时触发,event.code 和 event.reason 可查原因建议在 onerror 里至少打个日志,不然失败了也不知哪出问题。
连接打开后才能安全发送数据:
ws.send("hello server"); —— 只能发字符串、ArrayBuffer、Blob、TypedArrayws.close(); —— 主动断开,可选传入状态码和原因:ws.close(1000, "user logout")
如果 ws.readyState 不是 1(OPEN),调 send() 会直接报错。发之前建议判断:if (ws.readyState === WebSocket.OPEN) ws.send(...);
把上面串起来,一个最小可用片段:
const ws = new WebSocket("wss://echo.websocket.org"); // 公共测试地址
ws.onopen = () => console.log("已连接");
ws.onmessage = event => console.log("收到:", event.data);
ws.onerror = err => console.error("连接出错", err);
ws.onclose = event => console.log("已断开", event.code, event.reason);
// 3秒后发条消息(确保连接已建立)
setTimeout(() => {
if (ws.readyState === WebSocket.OPEN) {
ws.send("test message");
}
}, 3000);
基本上就这些。不复杂但容易忽略状态判断和错误处理,补上就稳了。