# WebSocket 测试器

从浏览器连接任意 WebSocket（ws:// 或 wss://）端点，收发消息，查看 open/close/error 事件及其错误码——调试实时 API 与 socket 连接的理想工具

> 标准页面: https://elysiatools.com/zh/tools/websocket-tester

- **分类:** Development

- **关键词:** websocket, ws, socket, socket 测试, 实时, wss, ws 客户端, websocket 客户端, socket 调试, 实时消息, 事件

## 概述

WebSocket 测试器是一款便捷的在线调试工具，允许您直接从浏览器连接到任意 WebSocket（ws:// 或 wss://）端点。它支持实时收发消息、自定义子协议以及自动重连，并能直观展示连接开启、关闭及错误事件，是开发和调试实时 API 与 Socket 连接的理想选择。

## 输入项

- **WebSocket URL** (text): wss://echo.websocket.events
- **子协议（可选）** (text): e.g. chat, graphql-ws
- **意外断开时自动重连** (checkbox)

## 适用场景

- 正在开发基于 WebSocket 的实时通信应用，需要快速验证服务端接口是否正常工作。
- 需要在不编写任何客户端代码的情况下，测试 WebSocket 服务端的连接稳定性或子协议兼容性。
- 排查生产或测试环境中的 WebSocket 连接故障，查看具体的连接关闭状态码或连接错误事件。

## 工作原理

- 在输入框中填写目标 WebSocket 地址（支持安全连接 wss:// 或非加密连接 ws://）。
- 根据需要填写子协议（Subprotocol）并勾选是否开启“意外断开时自动重连”选项。
- 点击连接按钮建立 Socket 通道，在交互面板中实时发送文本消息，并查看接收到的服务器响应及连接状态事件。

## 使用案例

- 实时聊天应用接口调试：发送 JSON 格式的聊天消息，验证服务端是否能正确广播给其他客户端。
- 订阅实时数据源：连接到股票行情或体育比分的 wss:// 数据源，观察数据推送的频率和格式。
- 异常断开与重连测试：模拟服务端断开连接，测试客户端的自动重连逻辑和状态码捕获。

## 常见问题

### 这个工具支持连接本地的 ws:// 服务吗？

支持。只要您的浏览器可以访问到本地服务（如 ws://localhost:8080），即可直接进行连接和测试。

### 为什么我的 wss:// 连接失败了？

请检查 URL 是否正确、服务端证书是否有效，以及是否存在跨域限制（CORS/Origin）或网络防火墙拦截。

### 什么是子协议（Subprotocol）？

子协议用于在 WebSocket 握手时协商特定的应用层协议（如 chat 或 graphql-ws），确保客户端与服务端使用相同的消息格式。

### 自动重连机制是如何工作的？

开启后，如果连接因网络波动或服务端异常而意外断开，工具会自动尝试重新建立连接，无需手动点击。

### 我可以在这里发送二进制数据吗？

本工具目前主要支持发送和接收文本格式的消息，用于快速调试 API 逻辑。

## 相关工具

- [HTTP 请求测试器](https://elysiatools.com/zh/tools/http-request-tester): 浏览器内的轻量 HTTP 客户端（迷你 Postman）：发送 GET/POST/PUT/DELETE 请求，自定义请求头与请求体，查看状态码、响应头、耗时与格式化响应——全部在浏览器内完成
- [Tailwind 色板同步器](https://elysiatools.com/zh/tools/tailwind-color-palette-sync): 输入一组 HEX,选择命名规则(色阶 50–950 / 单名 / 对象嵌套),自动生成 tailwind.config.ts 的 theme.extend.colors 片段,每个色阶同时给出 WCAG AA/AAA 对比等级,可选暗色模式。
- [API 契约变异测试器](https://elysiatools.com/zh/tools/api-contract-mutation-tester): 对 OpenAPI 请求字段做语义变异，并可发送到真实后端以检查防御性校验覆盖率
- [API 契约压力测试器](https://elysiatools.com/zh/tools/api-contract-stress-tester): 根据 OpenAPI 3.x 规范批量生成边界值测试请求，并可选发送到真实后端以发现契约不一致。
- [Cron 表达式解释器](https://elysiatools.com/zh/tools/cron-expression-explainer): 解析 5 段 / 6 段 / Quartz cron 表达式为自然语言调度描述，按字段拆解，并按任意 IANA 时区列出接下来 N 次执行时间，附带 AI 生成的本地化自然语言解释
- [域名提取器](https://elysiatools.com/zh/tools/domain-extractor): 从URL中提取域名。支持各种提取选项，包括子域名和路径分析。
- [GraphQL Playground](https://elysiatools.com/zh/tools/graphql-playground): 浏览器内的 GraphQL 客户端：编写查询与变量，发送到任意 GraphQL 端点，查看格式化的 JSON 结果或错误数组——开发阶段快速迭代 Schema 的理想工具
- [package.json 依赖审计器](https://elysiatools.com/zh/tools/package-json-dependency-auditor): 审计 package.json 的依赖卫生、版本范围质量，并可选地从 package-lock.json 或 yarn.lock 深入检查传递依赖树。会标记重复依赖、通配符或预发布版本、未排序键、缺失元数据，以及运行时/开发时依赖误分类问题。

## 示例

- [WebSocket 示例](https://elysiatools.com/zh/samples/websocket): 使用 WebSocket 协议的实时通信示例，包括聊天、通知和实时数据流
- [Web Python 图像处理示例](https://elysiatools.com/zh/samples/web-image-processing-python): Web Python 图像处理示例，使用 PIL/Pillow 包括读取、保存、缩放和格式转换
- [Android Java 图像处理示例](https://elysiatools.com/zh/samples/android-image-processing-java): Android Java 图像处理示例，包括图像读取保存、缩放和格式转换
- [Android Kotlin 图像处理示例](https://elysiatools.com/zh/samples/android-image-processing-kotlin): Android Kotlin 图像处理示例，包括图像读取保存、缩放和格式转换

## 相关内容

- [音频编码与格式转换工具](https://elysiatools.com/zh/hubs/audio-convert): 在一个专题里比较音频格式转换、码率调整、采样率转换、编码切换和导出工具，适合交付与归档工作流。
- [图片格式转换与动画导出工具](https://elysiatools.com/zh/hubs/image-convert): 在一个专题里比较 JPG、PNG、GIF、AVIF、WebP、TIFF、ICO、base64 以及动画导出相关的图片格式转换工具。
- [JSON 交换与格式翻译工具](https://elysiatools.com/zh/hubs/json-convert): 在一个专题里比较 JSON 与 CSV、YAML、TOML、GraphQL、XML、Markdown、Excel、BSON、EDN 等结构化格式之间的转换工具。
- [面向网页与印刷的色彩空间转换工具](https://elysiatools.com/zh/hubs/design-convert): 围绕网页到印刷的色彩空间转换整理的一组工具。
