Hoppscotch支持四种批量运行集合请求的方式:一、Web界面内置集合运行器;二、CLI命令行执行;三、桌面版集合运行器;四、Jenkins流水线集成CLI。

如果您已在Hoppscotch中创建了包含多个请求的集合,但需要一次性执行全部或部分请求而非逐个点击发送,则需借助其内置的集合运行器功能。以下是实现批量运行集合中请求的具体操作路径与方法:
一、使用Hoppscotch Web界面内置集合运行器
该方式无需额外工具,直接在浏览器中触发批量执行,适用于快速验证、调试阶段的轻量级批量运行。运行器会按顺序执行集合内所有启用的请求,并汇总结果。
1、在左侧“Collections”面板中,找到目标集合,点击右侧的“⋯”更多操作按钮。
2、从下拉菜单中选择Run collection选项。
3、弹出的运行配置窗口中,确认所选环境(如“dev-env”或“prod-env”),勾选Enable request execution以激活实际发送行为。
4、可选设置:调整请求间延迟(ms)、启用失败后继续(Continue on error)、是否跳过禁用请求等。
5、点击Run按钮,界面右上角将显示实时运行进度条与结果摘要面板。
二、通过Hoppscotch CLI命令行批量执行
此方式适用于CI/CD集成、定时任务或需结构化报告输出的场景。CLI支持离线执行、参数化环境注入及JSON格式报告导出,是自动化流程的核心载体。
1、确保系统已全局安装Hoppscotch CLI:npm i -g @hoppscotch/cli。
2、将Hoppscotch Web端导出的集合JSON文件保存至本地路径(如./collections/user-api.json)。
3、准备对应环境变量文件(如./envs/staging.json),内容需为标准JSON对象,含baseURL、authToken等键值对。
4、执行批量运行命令:hopp test ./collections/user-api.json -e ./envs/staging.json --output ./reports/staging-run-$(date +%Y%m%d).json。
5、运行结束后,控制台输出汇总统计(如total/passed/failed),且指定路径生成结构化报告文件。
三、利用Hoppscotch桌面版集合运行器
桌面版提供更稳定的本地执行环境,避免浏览器沙箱限制与跨域策略干扰,尤其适合内网API或需长期驻留运行器的测试终端。
1、启动Hoppscotch桌面应用(Windows/macOS/Linux),确保已登录并同步所需集合。
2、在集合列表中右键目标集合,选择Run collection上下文菜单项。
3、在弹出面板中,手动展开并勾选需参与本次批量运行的子文件夹或具体请求(支持多选过滤)。
4、点击Advanced options,设定并发数(Concurrent requests)、超时阈值(Timeout ms)及重试次数(Retry on failure)。
5、点击Start run,运行日志将实时滚动显示于底部控制台区域,各请求状态以颜色区分(绿色成功/红色失败/灰色跳过)。
四、通过Jenkins流水线调用CLI实现持续批量运行
当需将集合批量运行纳入软件交付生命周期,Jenkins可作为调度中枢,自动拉取最新集合定义、注入动态环境参数并归档历史报告。
1、在Jenkins节点安装Node.js与npm,并全局配置@hoppscotch/cli为可用命令。
2、在Jenkinsfile中定义pipeline stage,使用sh步骤执行CLI命令:
sh 'hopp test $COLLECTION_PATH -e $ENV_FILE --delay 500 --output $WORKSPACE/reports/${BUILD_ID}.json'
3、在构建参数中预设COLLECTION_PATH(如Git仓库中的集合路径)与ENV_FILE(根据分支自动映射到dev/test/prod环境文件)。
4、添加Post-build Action,使用Publish JUnit test result report插件解析CLI生成的JUnit兼容XML报告(需配合--junit参数启用)。
5、将$WORKSPACE/reports/目录下的JSON报告归档为构建产物,供后续审计或比对使用。

















