发送消息
Ctrl+Enter 发送
消息日志
还没有消息。连接并发送一条后,收发记录会出现在这里。
编码与文本
WebSocket 测试工具
WebSocket 是浏览器与服务器之间的一条长连接,握手成功后消息可以双向流动,不需要为每条消息重新发一次请求。这个页面就是一个跑在浏览器里的 WebSocket 客户端:粘贴 ws:// 或 wss:// 地址,点连接,输入内容,接收到的每条消息都会带上到达时间,并留在可一键重发的历史记录里。全部在浏览器本地运行,免安装、免账号,中间不经过任何服务器。
你能做什么
两秒连上,什么都不用装
粘贴 ws:// 或 wss:// 地址,点连接即可。不用装扩展、不用配 Node.js、不用注册账号 —— 连接由你的浏览器直接发起到你的服务端,你看到的握手过程和报错,跟你自己的应用里看到的完全一致。地址没写协议时,工具会自动补上。
JSON、纯文本、二进制都能发
编辑区分为 Text、JSON 和 Binary 三个标签页,JSON 标签页会自动格式化你输入的内容,二进制标签页用于发送字节流。发出去的消息带时间戳和方向箭头留在历史里,可以复制原始载荷、重发,或者把服务端回显的内容和你发的逐字对比。
每条回信都有时间,可重放
收到的消息按到达时间进入日志,并标注是文本还是二进制。可以筛选、复制单条,也可以把整场会话复制成 JSON。服务端回了 JSON 错误对象时,原始载荷就在眼前,不用再去翻控制台日志。
诊断直接指出真正的原因
握手失败时,页面会显示浏览器原始报错,并给出白话解释:404 是路径写错了,200 说明你连到的是普通 HTTP 接口而不是 WebSocket 接口,ws:// 被拦说明撞上了混合内容。如果页面是 https 而地址是 ws://,连接前就会先给警告。
免费、私密、无状态
不用注册,载荷不上传,服务端不存任何东西 —— 消息只在你的浏览器和你的服务端之间来回。想清空随时清空,关掉标签页会话就结束。
怎么用
- 01
粘贴地址并连接。把 wss://echo.websocket.org 或 ws://localhost:8080/ws 这样的地址填进地址栏,如果没写协议,工具会补上 ws://。然后点连接,看状态条变成 open。
- 02
发一条消息,看看回什么。在左侧编辑区输入内容 —— Text 发普通字符串,JSON 发带格式化的载荷,Binary 发字节 —— 然后点 Send 或按 Ctrl+Enter。你发出的和服务端回的每一条消息都会出现在右侧日志里,带到达时间和方向箭头。
- 03
读懂报错,再去修。连接没打开时,诊断条会解释浏览器的报错是什么意思、通常是什么原因造成的。等收发正常了,可以从日志里复制准确的载荷,或者把整场会话复制成 JSON,贴进你的测试用例或问题单里。
关于 WebSocket 测试
WebSocket 是什么,握手是怎么发生的
WebSocket 是一个协议,它把普通的 HTTP 连接升级成一条持久、可双向传输的通道。客户端用 HTTP Upgrade 请求发起连接,服务端回一个 101 Switching Protocols,从这一刻起,双方随时都能向对方推送消息,不需要再来一轮请求和响应。这就是它和普通 HTTP 的区别 —— HTTP 里只有客户端问了服务端才说话。WebSocket 本身不携带时区,也不带单位,它只负责搬运字节,至于某一帧是 JSON、纯文本还是 protobuf,由应用自己定义。URL 协议是约定的一部分:ws:// 是不加密的版本,wss:// 是同一协议套了 TLS,两者在握手之上行为完全一致。
怎么在浏览器里测一个 WebSocket 接口
测试一个 WebSocket 接口无非四件事:握手能不能成功、你的载荷是不是原样发出去了、服务端的回信是不是按预期回来了、以及出问题时能不能把两者区分开。这个页面把四件事在一条连接上覆盖完整,对绝大多数 API 工作已经够用。也值得知道其他方案各有什么代价。Postman 也支持 WebSocket,但要装桌面客户端、注册账号,才能保存载荷模板。wscat 免费又好用,但需要 Node.js 和终端 —— 当载荷是从一个浏览器 bug 报告里复制出来的时候,终端不是合适的地点。Chrome DevTools 一直在那儿,可它的 WebSocket 面板是一个「看」的工具:能看到帧流过,但你没法保留一份可以重发的历史,而且面板必须在连接建立之前就打开。如果你要的是一个临时的服务器而不是客户端,这个页面给不了:自己起一个服务,或者用 wss://echo.websocket.org 这样的公共回显端点,然后把这个页面指向它。
怎么读懂失败的握手
握手失败时,浏览器会报一个错,连接根本不会建立。你会认得这句话 —— "Error during WebSocket handshake: Unexpected response code: 400",里面的数字就是服务端本该返回 101、却实际返回的 HTTP 状态码。404 通常是路径写错,或者路由注册在别的前缀下。401 或 403 说明服务端要凭证而你没给。200 是个很好的线索:你指到的是一个普通 HTTP 接口,因为 WebSocket 服务端回升级请求的答案只有 101。301 或 302 表示服务端想重定向这次升级请求,而浏览器不会跟随重定向。502 或 503 通常指向服务端前面的代理或网关,而不是你自己的代码。握手进行到一半连接被重置,说明还没谈完就有人把 socket 关了。另外还有一个独立的坑:如果页面本身是 https 提供的,而你的地址以 ws:// 开头,浏览器会在一个字节都没发出去之前就按混合内容拦下来 —— 换成 wss://,或者本地开发时让前端也跑在 http 上。
和其他客户端怎么比
| 对比项 | 1Tools | Postman | wscat | Chrome DevTools |
|---|---|---|---|---|
| 安装 | 不用装 —— 打开页面即可 | 桌面应用 | Node.js + npm | 内置于 Chrome |
| 账号 | 不用注册 | 保存模板需要账号 | 不需要 | 不需要 |
| 可重放历史 | 有 —— 带时间戳的日志,可从中重发 | 配置后可保存请求 | 只有终端回滚缓冲 | 仅查看;面板须先打开 |
| 自定义请求头 | 不行 —— 浏览器限制 | 可以 | 可以 | 不行 —— 浏览器限制 |
| 最适合 | 快速浏览器侧排查与问题复现 | 已保存的集合与团队流程 | CLI 脚本与 CI | 在已有页面里观察帧 |
免费、私密、免安装
免安装、免账号
打开页面直接连。没有扩展、没有 Node.js、不用注册、不用配 API key。
消息只在你和你的服务端之间
本站没有承接你载荷的后端,数据帧从你的浏览器直达你输入的地址,不去别处。
随时清空日志
消息历史只存在于这个页面里,清掉或关掉标签页就没了,不保留任何东西。
对能力边界说实话
浏览器不能设自定义请求头,也发不了协议层 ping。这个页面会告诉你哪些能做、哪些不能,而不是假装都能做。
常见问题
JSON 格式化与校验JSON 对比文本对比全部工具返回首页
反馈
碰到看不懂的报错、缺诊断,或希望本页更好支持某种载荷形态?告诉我们 —— 真实反馈会决定下一轮 FAQ 和界面调整。