Hoppscotch自动化需启用工作流能力,具体包括:一、用预请求脚本与测试构建单请求链;二、用集合编排多请求执行流;三、用CLI批量运行集合;四、用GitHub Actions自动触发测试;五、用环境变量实现多场景切换。

如果您在Hoppscotch中重复执行一系列API请求,但尚未建立可复用、可调度的执行序列,则说明当前尚未启用其内置的工作流自动化能力。以下是实现请求自动化流程的具体配置步骤:
一、使用预请求脚本与后请求测试构建单请求自动化链
该方法通过JavaScript脚本在单个请求生命周期内完成参数动态生成、状态验证与变量传递,构成最小粒度的自动化单元。所有脚本在隔离沙盒中执行,保障安全性与稳定性。
1、在请求编辑界面点击“Pre-request Script”标签页,输入JavaScript代码设置动态变量。
2、在“Tests”标签页中编写断言脚本,例如验证响应状态码是否为200。
3、使用pw.env.set()将响应中的token或ID保存至环境变量,供后续请求引用。
4、在其他请求的URL或Body中使用{{variable_name}}语法调用已设变量。
二、通过集合(Collection)组织多请求有序执行流
集合是Hoppscotch中定义请求执行顺序与分组逻辑的核心结构,支持按业务流程编排多个请求,形成线性或条件分支式工作流基础。
1、点击左侧导航栏“Collections”,选择“Add new Collection”创建新集合。
2、为集合命名并添加描述,例如“用户注册-登录-信息获取全流程”。
3、依次添加GET/POST等请求,确保顺序符合实际调用依赖关系。
4、在每个请求的“Tests”中添加pm.test("Next request ready", function() { pm.expect(pm.response.code).to.equal(201); });作为流转判断依据。
三、利用Hoppscotch CLI在终端批量运行集合
CLI工具将集合导出的JSON文件作为输入,在无GUI环境下驱动完整请求流,适用于CI/CD集成与定时任务场景。
1、在Hoppscotch Web界面导出目标集合为user-flow.json文件。
2、准备环境变量文件staging.env.json,包含{"baseURL": "https://staging.api.example.com"}。
3、执行命令:hopp test user-flow.json -e staging.env.json --output report.json。
4、检查生成的report.json中"passed"字段确认流程执行结果。
四、配置GitHub Actions自动触发集合测试
通过GitHub仓库事件(如push到main分支)触发CLI测试,实现代码变更即验证的闭环反馈机制,无需人工介入。
1、在项目根目录创建.github/workflows/api-test.yml文件。
2、在workflow中声明使用actions/checkout@v3拉取最新代码与测试集合文件。
3、添加步骤安装Hoppscotch CLI:npm install -g @hoppscotch/cli。
4、执行测试命令并上传报告为workflow artifact:hopp test ./tests/integration.json -e ./env/prod.json --output ./artifacts/test-result.json。
五、基于环境变量实现多场景自动化切换
同一套集合可在不同环境配置下自动适配目标服务地址、认证方式与数据模板,避免维护多份重复集合。
1、点击顶部导航栏“Environment”→“Manage Environments”,创建dev、staging、prod三个环境。
2、在各环境中分别设置baseURL、authToken、timeoutMs等键值对。
3、在请求URL中统一使用{{baseURL}}/users,Header中使用{{authToken}}。
4、运行时通过CLI的-e参数或Web界面下拉菜单切换生效环境,无需修改集合内容本身。