Hoppscotch

详细介绍

Hoppscotch（原 Postwoman）是一款开源的 API 开发与测试工具，支持 REST、GraphQL、WebSocket、gRPC 等多种协议。它采用现代化界面设计，提供直观的请求构建、响应查看和测试功能，适合开发者快速调试 API 或团队共享文档。

核心功能

1. 多协议支持

• REST/HTTP：支持 GET、POST、PUT 等请求方法，可自定义 Headers、Query 参数和 Body（JSON、Form 等格式）。
• GraphQL：内置 GraphQL 编辑器，支持自动补全和语法高亮，可直接测试 GraphQL 接口（如查询、变更）。
• WebSocket/gRPC：实时连接 WebSocket 服务或测试 gRPC 接口，查看消息收发记录。

2. 请求管理与分组

• 集合（Collections）：将相关请求组织到集合中，支持文件夹层级管理，方便团队协作和批量执行。
• 环境变量：定义不同环境的变量（如开发环境 dev-api.com、生产环境 prod-api.com），一键切换。

3. 响应可视化与分析

• 格式化显示：自动格式化 JSON、XML、HTML 响应，支持语法高亮和折叠展开，方便查看复杂数据结构。
• 响应时间分析：显示请求耗时（DNS 解析、TCP 连接、服务器处理等阶段），帮助定位性能瓶颈。

4. 自动化测试

• 测试脚本：使用 JavaScript 编写测试逻辑，验证响应状态码、JSON 字段值等。例如：

  // 断言响应状态码为 200 且包含 "success" 字段
  pm.test("Status code is 200", () => {
    pm.response.to.have.status(200);
  });
  
  pm.test("Response contains success", () => {
    const json = pm.response.json();
    pm.expect(json).to.have.property("success").to.be.true;
  });
  

• 批量运行：通过 Runner 批量执行集合中的请求，生成测试报告。

5. 团队协作与分享

• 导出/导入：支持将集合导出为 JSON 或导入其他工具（如 Postman）的格式，便于团队共享。
• 公开分享：将 API 文档生成为可分享的链接，支持设置密码保护，方便与外部团队协作。

典型使用场景

1. API 快速调试

   • 开发人员快速验证接口逻辑，例如测试登录接口返回的 Token 是否正确，或检查文件上传功能是否正常。
2. GraphQL 接口测试

   • 针对 GraphQL 服务编写复杂查询，验证字段返回是否符合预期，例如：

   query GetUser($id: ID!) {
     user(id: $id) {
       name
       email
       posts {
         title
         createdAt
       }
     }
   }
   

3. WebSocket 实时通信测试

   • 连接 WebSocket 服务（如聊天应用、实时数据推送），发送和接收消息，监控通信状态。
4. 团队文档与协作

   • 将常用请求整理成集合并生成公开文档，供前端、后端和测试团队共享，减少沟通成本。

与其他工具对比

快速入门

1. 使用方式

   • Web 版：直接访问 Hoppscotch 官网 使用，无需安装。
   • 桌面版：从官网下载对应系统的安装包（Windows/macOS/Linux），支持离线使用。
2. 发送第一个请求

   • 选择请求方法（如 GET），输入 URL（如 https://jsonplaceholder.typicode.com/posts/1），点击 Send 发送请求。
3. 管理集合

   • 点击左侧 Collections，创建新集合并添加请求，支持重命名、排序和搜索。
4. 设置环境变量

   • 点击右上角 Environments，添加变量（如 baseUrl），在请求中使用 {{baseUrl}} 引用。

注意事项

• 数据存储：Web 版数据默认存储在浏览器本地（LocalStorage），需手动导出备份；桌面版支持同步至云端账户。
• 扩展性：插件生态不如 Postman 丰富，复杂自动化场景可能需依赖外部工具。
• 性能测试：基础版本不支持高并发性能测试，需使用专业工具（如 JMeter）。

Hoppscotch 凭借其简洁的界面和全面的协议支持，成为开发者快速验证 API 的理想选择。尤其适合个人开发者或小型团队，既能满足日常调试需求，又能通过公开分享简化协作流程。如果你追求轻量级、美观的工具体验，Hoppscotch 是不错的选择。