zh-Hans v
en zh tw

Socket.IO 测试

连接 Socket.IO 服务器,发送 JSON 或二进制事件,等待确认回执,检查命名空间与传输事件。

连接时数据将直接传到指定服务器。

连接正确的命名空间

输入不含路径或查询的 HTTP(S) 源站。Engine.IO 路径与 Socket.IO 命名空间分别设置,默认是 /socket.io/ 和 /。认证接受 JSON 对象,查询参数接受标量对象,并排除 Engine.IO 保留键。示例只填入演示源站,不会自动连接。

本工具内置 socket.io-client 4.8.4,使用 Engine.IO 协议 4 和 Socket.IO 协议 5,面向兼容的 Socket.IO 3.x/4.x 服务器,不适用于 1.x/2.x、原始 WebSocket、MQTT 或 SSE。请核对服务器兼容性及启用的传输方式。

发送参数并检查回复

JSON 模式需填写参数数组:[{"message":"你好"},42] 会发送两个参数,而不是一个 JSON 字符串。十六进制模式发送一个字节数组。收到的二进制内容导出为带 $binary 十六进制值与 bytes 数量的对象,表示接收字节,不代表服务器原始 JavaScript 对象类型。

选择等待回执后会附加确认回调,超时可设 1–30 秒。回执与普通入站事件分别记录;超时不能证明服务器未处理事件。每次点击只发送一次,不自动重发。需要客户端回执的入站事件会被标注,但本工具不会自动确认。

传输、凭据与生命周期

自动模式先轮询,再尝试升级 WebSocket;也可单独使用轮询或 WebSocket 排查问题。包含凭据控制跨源轮询;浏览器 WebSocket 握手可能独立发送符合条件的 Cookie。轮询需要 CORS,所有传输仍受服务器 Origin 检查、TLS 与浏览器安全策略约束,不提供自定义握手请求头。

连接超时可设 1–30 秒,不自动重连,断开后需手动再次连接。修改连接设置会关闭旧 Manager 并清空报告;修改事件参数保留连接。断开与清除会关闭会话,离开页面也会释放资源。连接与认证设置不持久保存。

有界日志与导出

日志最多保留 1,000 条或 2 MiB,超限会断开。单个事件参数正文限 1 MiB,出站 JSON 最多 32 个参数,检查层级限 32、节点限 10,000。最多等待 20 个回执,传输积压超过 100 个包后拒绝继续发送。客户端库和浏览器可能先收到数据,再执行应用层检查。

预览只显示前 200,000 字符,复制与下载保留整个有界报告。连接日志不复制认证内容,但服务器可能在事件数据中回显。此工具用于手动协议调试,不是压力测试或消息送达保证检查器。

常见问题

为什么 WebSocket 回显服务器连不上?

Socket.IO 还有 Engine.IO 握手和自身的数据包协议。原始 WebSocket 端点请使用 WebSocket 测试工具。

没有回执就代表事件失败吗?

不是。服务器可能已处理却没有调用回执,也可能回复丢失。重试操作可能造成重复效果。

其他语言

Socket.IO Tester — Base64.sh

Socket.IO 测试

连接 Socket.IO 服务器,发送 JSON 或二进制事件,等待确认回执,检查命名空间与传输事件。

分享:

X Facebook LinkedIn Reddit

参考资料

我们如何确保结果正确

我们使用以下自动化测试验证此工具。下方保留测试用例的原始名称,便于查看实际断言和复现。

验证方法
连接本地实际 Socket.IO 服务,检查 namespace、auth/query、JSON、二进制、ack、超时和断开。
对比依据
socket.io 服务端与页面的 Socket.IO 客户端互操作。
验证范围
这是协议集成测试,不是不同 Socket.IO 引擎间的独立实现对比。
测试源码与用例(点击文件名查看)
  • stream-tools.test.js
    • Socket.IO options separate origin, engine path, namespace and protocol transports
    • Socket.IO JSON argument arrays and exact binary payloads reject reserved names and bad formats
    • Socket.IO log normalization preserves nested binary, rejects huge/deep/cyclic data and prototype keys safely
    • Socket.IO actual server checks namespace/auth/query, JSON, binary, acknowledgements and manual disconnect
    • Socket.IO actual acknowledgement timeout, server rejection, stale generation and pending cap
    • Socket.IO connection deadline covers an unacknowledged namespace after Engine.IO is open

这些测试覆盖列出的样本和边界,不代表所有输入都已证明正确。往返测试和使用同一依赖库的检查,不属于独立交叉验证。