JavaScript WebSocket 怎样处理 close 事件的 code 和 reason
处理 JavaScript WebSocket 的 close 事件时,读取 event.code 判断关闭类别,用 event.reason 获取可能为空的说明,并单独记录 event.wasClean。不要把 reason 当成必填业务错误,不要从 wasClean 推断消息已经处理成功,也不要仅凭 1006 确定是断网、服务器故障还是握手失败。
WebSockets 标准地址:https://websockets.spec.whatwg.org/
我会先改关闭后的页面状态,再决定是否需要恢复连接。下面以“实时频道”的退出提示为设计示例,说明如何改造已有处理逻辑;这是对现有 API 使用方式的调整,不是浏览器新版本公告,也不声称来自某次线上故障实测。
从关闭后的页面状态改起
设想用户已经点击“退出频道”,页面随后收到 close。如果旧处理器对所有关闭都提示“网络错误,请重试”,用户会以为退出失败。另一个常见问题是把任何正常关闭都显示成“保存成功”,但连接结束与业务确认根本不是同一个条件。
我更倾向于让连接事件只负责连接状态:关闭后停止把该连接当成可发送通道,把待确认的业务状态留给业务协议处理。是否自动重连是另一个应用策略,不能由 close 事件名称替你决定。
这次改造的变化很小:在既有 close 监听器旁保留本地退出意图,并完整保存关闭字段。无需为此更换通信库,也不要把旧连接对象重新当成新连接。
把 code、reason 和 wasClean 分开理解
close 监听器接收 CloseEvent。code 是关闭码,reason 是关闭说明,wasClean 表达连接是否干净地关闭。这些基础定义见 MDN close 事件文档与 WebSockets 标准。
| 信息 | 适合表达什么 | 不能据此断言什么 |
|---|---|---|
| code | 协议关闭类别或约定的应用码 | 所有客户端可见的码都可传给 close() |
| reason | 可选的关闭说明 | 一定存在,或一定是可解析的 JSON |
| wasClean | 关闭是否干净完成 | 最后一条业务消息已落库 |
| requestedStop | 本地用户是否请求退出 | 这是 CloseEvent 自带字段 |

1006 尤其值得谨慎处理:多种连接失败都可能对脚本呈现这个码,浏览器不会给页面公开所有底层细节。因此,“连接异常中断”是合适的页面描述,“一定是证书过期”则超出了字段所能证明的范围。诊断需要结合环境与服务端记录,而不是对同一个数值赋予唯一故障原因。
给现有连接增加关闭处理
下面的函数接收已有 socket 和用于提示的 statusNode,返回可以交给退出按钮调用的 stopChannel。它只绑定关闭处理,不创建网络连接、不自动重试。requestedStop 是这个绑定实例内的状态;下一条新连接需要重新调用函数创建自己的处理器。
function bindChannelClose(socket, statusNode) {
let requestedStop = false;
socket.addEventListener("close", (event) => {
// 保留三个独立字段,reason 为空也是合法情况
const report = {
code: event.code,
reason: event.reason,
wasClean: event.wasClean,
requestedStop
};
console.info("连接关闭记录", report);
// 本地退出意图优先,避免主动退出后仍弹出重试提示
if (requestedStop) {
statusNode.textContent = "已退出实时频道";
} else if (event.code === 1000) {
statusNode.textContent = "实时频道已结束";
} else if (event.code === 1006) {
statusNode.textContent = "连接意外中断,请检查后重新连接";
} else {
statusNode.textContent = "实时连接已关闭,关闭码:" + event.code;
}
// 只作为纯文本补充显示,不把远端字符串当成 HTML
if (event.reason) {
statusNode.textContent += ";说明:" + event.reason;
}
}, { once: true });
return function stopChannel() {
// 这是本地应用状态,不能由 event.code 反推
requestedStop = true;
if (socket.readyState === WebSocket.OPEN ||
socket.readyState === WebSocket.CONNECTING) {
socket.close(1000, "user-left");
}
};
}
绑定应发生在创建连接后尽早的位置。示例假定传入的连接尚未完成关闭,statusNode 是有效页面元素;对一个早已关闭的对象事后添加监听器,不会补发过去的 close 事件。once: true 表达这份监听器只处理该对象的一次关闭。
字段记录和页面文案也应分工。code 与 wasClean 是结构化记录,reason 是补充说明。示例用 textContent 展示说明,避免把它误当 HTML。生产日志还应按项目要求处理可能包含敏感内容的说明文本。
本地点击退出与远端同时关闭可能相遇。这里的 requestedStop 只决定“用户已经要求退出,不再催促重连”的交互政策,并不证明是哪一端先发起协议关闭。这个取舍适合退出频道;需要审计发起方的系统不能拿它替代协议和服务端证据。
主动关闭时遵守参数限制
读取 event.code 与传入 socket.close(code, reason) 的允许范围不同。浏览器主动关闭时,可显式传入 1000 或 3000–4999 的整数;reason 按 UTF-8 编码不得超过 123 字节。中文字符占用的字节数与字符串长度不同,不能只检查 reason.length。参数约束见 MDN close() 文档。
function closeWithNote(socket, note) {
// 这里固定使用正常关闭码,不把收到的任意 code 原样回传
const reason = String(note);
if (new TextEncoder().encode(reason).byteLength > 123) {
throw new RangeError("关闭说明超过 UTF-8 字节限制");
}
socket.close(1000, reason);
}
上面的辅助函数让超长说明以明确的本地错误暴露,调用方应缩短或移除说明后处理。实际应用最好传简短、稳定的标记,并另外维护用户可读文案;示例的 user-left 就属于本项目自行选择的说明,不是标准保留词。
close() 启动关闭操作,并不等于同步完成关闭。不要在调用后立即报告“对方已经完成业务处理”。在关闭期间与最终关闭之后,也不要继续按 OPEN 状态发送业务消息。

迁移旧代码时核对这些分支
迁移旧代码时,我会先把“每次 close 都立即重连”移出监听器,再分别定义主动退出、正常结束和异常中断的页面状态。对于前后端约定的应用码,按你们的协议增加分支,不能把某个项目里的含义当成所有 WebSocket 服务的通用规则。
以下是预期行为对照,供你在自己的开发环境演练;它不是本次运行结果。本文示例未执行网络连接或本地测试。
- 用户调用返回的 stopChannel:本地意图标记为退出,关闭提示不再催促恢复。
- 收到 code 为 1000 且没有本地退出意图的事件:显示频道结束,不显示保存成功。
- 收到 code 为 1006 的事件:显示异常中断,不自动断言单一根因。
- 收到空 reason:保留基本关闭提示,不尝试 JSON.parse。
- 主动关闭说明超长:调用方处理本地异常,不能把它登记成已经收到的远端关闭。
如果页面还维护定时任务,应把该连接所属任务的停止放进自己的资源管理逻辑。恢复连接时创建新实例并重建绑定,避免让旧连接的回调修改新连接的页面状态。
常见问题
reason 为空是服务端有问题吗?
不能这样判断。页面应能处理没有可用说明的关闭,把关闭码与本地上下文一起保留。
可以用 close(1006) 模拟异常关闭吗?
不可以,它不在浏览器主动 close 的有效参数范围内。读取到的事件码不能不加区分地作为主动关闭参数。
wasClean 为 true 就不需要检查业务消息了吗?
仍需按照业务协议检查消息确认。连接关闭状态只属于连接层;把它当成保存凭证会产生错误反馈。
JavaScript EventTarget.addEventListener 怎样使用 signal 自动解绑
- 上一篇
- JavaScript EventTarget.addEventListener 怎样使用 signal 自动解绑
- 下一篇
- JavaScript createHTMLDocument 怎样在独立文档中组装 HTML
-
- 文章 · 前端 | 10分钟前 | 前端 · javascript · JavaScript iframe document importNode createHTMLDocument DOMImplementation
- JavaScript createHTMLDocument 怎样在独立文档中组装 HTML
- 329浏览 收藏
-
- 文章 · 前端 | 26分钟前 |
- JavaScript structuredClone 复制 Error 对象怎样保留错误信息
- 261浏览 收藏
-
- 文章 · 前端 | 30分钟前 | 前端 · JavaScript Fetch AbortController AbortSignal abort reason
- JavaScript AbortController.abort(reason) 怎样把取消原因传给调用方
- 423浏览 收藏
-
- 文章 · 前端 | 34分钟前 | 前端 · 错误处理 · JavaScript Fetch response HTTP 404
- JavaScript fetch 怎样区分网络失败和 HTTP 404
- 239浏览 收藏
-
- 文章 · 前端 | 35分钟前 | 前端 · javascript · 性能排查 · JavaScript requestAnimationFrame ResizeObserver 前端布局 ResizeObserver loop
- JavaScript ResizeObserver 怎样避免观察回调循环
- 478浏览 收藏
-
- 文章 · 前端 | 41分钟前 | 前端 · 路由 · javascript · JavaScript 命名参数 相对URL URLPattern URLPattern.exec baseURL
- JavaScript URLPattern.exec 怎样用 baseURL 匹配相对路由地址
- 283浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · javascript · JavaScript DOM遍历 NodeIterator referenceNode
- JavaScript NodeIterator.referenceNode 怎样读取迭代器当前参照的节点
- 326浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · JavaScript Event defaultPrevented
- JavaScript Event.defaultPrevented 怎样判断事件默认行为是否已经被取消
- 391浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · javascript · 浏览器API · JavaScript Selection focusNode focusOffset DOM Node 文本选择
- JavaScript Selection.focusNode 怎样取得用户当前延伸选择的端点节点
- 492浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · javascript · JavaScript CSSOM CSSStyleSheet CSSRule parentStyleSheet cssRules parentRule
- JavaScript CSSRule.parentStyleSheet 怎样取得一条规则所属的样式表
- 323浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1128次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1112次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1287次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1227次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1078次使用
-
- Go语言对前端领域的入侵WebAssembly运行原理
- 2022-12-31 130浏览
-
- golang基于websocket通信tcpkeepalive研究记录
- 2022-12-23 311浏览
-
- golang实现一个简单的websocket聊天室功能
- 2022-12-28 447浏览
-
- Golang使用WebSocket通信的实现
- 2022-12-26 493浏览
-
- 使用Go语言创建WebSocket服务的实现示例
- 2022-12-28 156浏览

