使用 new websocket(url) 初始化,url 必须以 ws:// 或 wss:// 开头;连接异步,需立即绑定 onopen、onmessage、onerror、onclose 事件处理函数。

直接用 new WebSocket(url) 就能初始化,这是浏览器原生支持的 API,无需额外引入库。
URL 格式要写对
地址必须以 ws://(非加密)或 wss://(加密,推荐用于生产环境)开头,不能是 http 或 https:
-
✅ 正确示例:
new WebSocket('wss://api.example.com/chat') -
❌ 错误示例:
new WebSocket('https://api.example.com/chat')(会报错:Invalid URL)
创建后立即监听关键事件
WebSocket 连接是异步建立的,不能假设 new 之后就立刻可用。必须在实例创建后、连接完成前绑定事件处理函数:
-
onopen:连接成功后触发,适合发初始消息或启动心跳 -
onmessage:收到服务端数据时触发,event.data是字符串或 ArrayBuffer -
onerror:连接失败或传输异常时触发(注意:它不带具体错误码,需结合 console 或重连逻辑判断) -
onclose:连接关闭时触发,event.code可区分是否为正常关闭(如 1000)
简单可运行的初始化代码
以下是最小可行结构,可直接贴进 HTML 的 script 标签中运行:
const ws = new WebSocket('wss://echo.websocket.org'); // 公共测试地址
ws.onopen = () => {
console.log('已连接');
ws.send('Hello from browser');
};
ws.onmessage = (event) => {
console.log('收到:', event.data);
};
ws.onerror = (event) => {
console.error('连接出错', event);
};
ws.onclose = (event) => {
console.log('连接关闭,code:', event.code, 'reason:', event.reason);
};Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











