实际看Swell，先要确认它的用途：Swell：API 开发工具，使开发人员能够测试通过流技术提供服务的端点，包括服务器发送事件 (SSE)、WebSockets、HTTP2、GraphQL、gRPC 和tRPC..。软件开发里，依赖、接口和异常处理往往比主路径更影响采用。我会在隔离分支完成一个可回滚的小任务，检查安装步骤、接口契约、测试结果和错误信息。它适合需要可检查开发流程而非单次演示的工程师；采用前仍要看维护状态和试跑结果。

膨胀

Swell 是一款 API 开发工具，使开发人员能够测试 HTTP2、GraphQL 端点以及通过流技术提供服务的端点，包括服务器发送事件 (SSE)、WebSockets、gRPC、 WebRTC 和 OpenAPI。

开始使用

访问 www.getswell.io 下载最新版本。

Swell 适用于 OSX、Linux 和 Windows。

亮点

Swell 是发送和监控 API 请求的一站式商店：

• 通过 HTTP/2（包括 SSEs）和 WebSockets 发送和监控流
• 创建 GraphQL 查询、内省、突变和订阅
• 通过视频、音频和文本通道测试 WebRTC 应用程序
• 压力测试HTTP/2和GraphQL端点
• 创建您自己的 HTTP/2 模拟服务器
• 存储多个请求的工作区以供以后使用
• 在本地导入和导出工作区
• 使用 Chai 风格的 TDD/BDD 断言语法在 JavaScript 中编写测试套件

考虑在未来迭代 Swell？

我们强烈建议您查看 docs 文件夹中的 DEV-README.md。我们提供了有关最新更新的综合指南、哪些领域将受益于未来的迭代以及核心组件的详细信息。

核心特点

• HTTP2：Swell 支持请求和响应的完整 HTTP2 复用。 HTTP 对同一主机的请求将通过同一连接发送。默认情况下，Swell 将尝试为所有 HTTPS 请求启动 HTTP2 连接，并能够针对旧服务器恢复到 HTTP1.1。每个连接允许多个并发流。

• GraphQL：Swell 完全支持 GraphQL 的所有三种根类型 - 查询、突变和订阅 - 以及内省。还支持变量，使创建查询变得容易。

• 服务器发送的事件 (SSE)：由一个简单的切换框启动，Swell 在 SSE 事件进入时一一显示它们。与 HTTP2 流类似，SSE 允许多个打开的连接流。

• WebSockets (WS)：Swell 支持通过 HTTP 握手直接连接到 WebSocket 服务器，开发人员能够直接向连接的 WS 服务器发送消息。所有发出和传入的消息都会实时显示。

• gRPC：Swell 完全支持 gRPC 的所有四种流类型 - 一元、客户端流、服务器流、双向流。

• tRPC：Swell 完全支持 TypeScript 远程过程调用的所有方法，包括对查询、突变以及订阅的批量调用支持

  当前正在使用 http get 和 post 请求使用 TRPC 的 http RPC 规范进行调用（请参阅 RPC 文档）。 TLDR-查询过程的输入将转换为 uri 编码的 json 字符串并作为查询参数发送，而 mutate 过程的输入将存储在主体内部。

  批量请求可以通过在发送请求之前添加多个过程来进行，所有查询过程将一起批处理为一个单独的 get 请求，所有 mutate 过程将一起批处理为一个单独的 put 请求，如果一个请求中混合有查询和 mutate 过程调用，应用程序将同时发出 post 和 get 请求，并将响应合并为一个响应。

  嵌套端点必须遵循通用格式 parentEndpoint.childEndpoint.grandchildEndpoint。例如：

  client.user.update.mutate({ userId: '1', name: 'Luke' });
  

  对上述端点的请求必须从下拉菜单中选择 mutate 选项，端点必须为 .user.update，输入正文为 {"userId": "1","name": "Luke"}

有关发送 tRPC 请求或设置 tRPC 服务器的更多信息，请参阅 tRPC 文档。

• WebRTC：Swell 可以轻松测试 WebRTC 应用程序的视频、音频和文本通道。目前Swell支持手动录入SDPs。

  使用应用程序生成的报价和答案设置文本通道连接的演练：

  • 步骤1 Caller: Generate an offer by clicking “Get Offer.” Copy the offer to your computer's clipboard and send it to recipient (we recommend sending by email).
  • 步骤2 Recipient: Copy the offer you received from the caller and paste it into the offer box (the top text box)
  • 步骤3 Recipient: Click “Get answer” button, generate an answer and copy it to your computer's clipboard. Send it to caller (email recommended)
  • 步骤4 Caller: Copy answer to your computer's clipboard and paste it into the answer box (bottom text box).
  • 步骤5 Caller: Click the “add answer” button. Now the connection is open!
  • 步骤6 Caller: Click “add to workspace” button.
  • 步骤7 Recipient: Click “add to workspace” button.
  • 步骤8 Caller: Click "Send" button on the left-hand side of the app.
  • 步骤9 Recipient: Click "Send" button on the left-hand side of the app.
  • 步骤10 Send and receive text messages via the response panel at the bottom of the app.

附加功能

• HTTP/2 和 GraphQL 的压力测试：使用 Swell 的压力测试功能测试您的服务器后端，以确保您的服务器能够相应地管理预期和意外负载

• 直接向端点发送请求：您可以立即向端点 OR 发送请求，在工作区中暂存请求以进行多级测试。

• Swell 中的脚本：如果您喜欢测试驱动开发，Swell 允许您编写断言测试来帮助定义和测试后端 API 服务。

• 工作空间：Swell 允许您保存工作空间，以便更轻松地测试多个请求。

• 预览：您现在可以查看某些 API 响应的渲染预览 (HTML)

• Collection Runner：您还可以在工作区中暂存请求并自动发送每个请求的过程。无需在每一个上手动按发送；相反，每个请求都会按照暂存的顺序触发。

• 文件 Upload/Dark 模式：如果单击正文下拉菜单，则可以选择二进制，这允许您上传可与任何请求一起发送的文件，以测试后端文件上传路由。此外，您可以通过右上角的按钮切换黑暗模式。

实验特点

• Mock Server：Swell 允许您创建自己的 HTTP/2 模拟服务器，以方便前端开发，而无需依赖于完全构建的后端服务器。

• Webhooks：Swell 包含用户定义的 HTTP 回调连接测试，旨在测试其他服务器与 Web 的连接以及发送数据的能力。该测试确保当事件发生时，源站点向为 Webhook 配置的 URL 发出 HTTP 请求。

• OpenAPI：Swell 支持枚举和执行 REST 和 RPC API 请求，如用户提供的 OpenAPI 文档中定义的那样。

内置

• 电子
• 反应
• 反应路由器
• 材质 UI
• Redux 工具包
• 阿波罗客户端
• 网络套接字
• gRPC-js
• tRPC
• VM2
• Chart.js
• 布尔玛
• IndexedDB
• 柴
• 摩卡
• 剧作家