ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Bruno CLI 快速上手:3 步在命令行跑通 API 集合并生成测试报告

Bruno CLI 快速上手:3 步在命令行跑通 API 集合并生成测试报告 Bruno CLI 快速上手3 步在命令行跑通 API 集合并生成测试报告【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno你还在打开图形界面逐个点击请求做回归吗测试结果一关窗口就无处可查。本文带你用 Bruno CLI 一条命令跑完整个 API 集合并生成能直接接进 CI 的 JUnit 报告。场景引入发布前那个翻车晚上昨晚发布前你打开 Bruno 逐个点发送测到第 15 个请求才想起 URL 还指向预发环境等测完又发现结果没有存到任何地方拿不出报告给团队看。这种手动点测其实一行终端命令就能干完。先懂再练Bruno CLI 在项目里是什么角色Bruno 的集合Collection本质是磁盘上一个装着.bru文件的目录图形界面和 CLI 读的是同一份文件。CLI 包位于仓库的 packages/bruno-cli运行时不启动应用直接读取目录、按顺序发请求、汇总结果天然适合 CI 和定时任务。执行逻辑集中在 run 命令源码。能力Bruno GUIBruno CLI执行方式逐个手动点击请求一条命令批量跑整个集合切换环境界面下拉框选择--env命令行参数结果留存仅应用内可见json/junit/html 报告文件典型场景交互式调试回归、CI、定时任务动手从安装到第一份报告1. 安装 CLI 并确认版本全局执行npm install -g usebruno/cliCLI 以 npm 包分发有 Node.js 环境一条命令即可。装完在终端跑bru --version能输出版本号就说明就绪。2. 跑通整个集合cd进集合根目录bruno.json所在处执行bru run。不带路径参数时会递归跑全部请求也可以只跑单个文件或子文件夹如bru run login.bru、bru run auth -r-r表示递归包含子文件夹。跑完终端会打印执行汇总通过/失败数、断言数、耗时。3. 绑定环境与覆盖变量集合的environments/子目录放着一份或多份环境文件.bru/.json/.yml用--env加载只想临时改一个变量就追加--env-var可写多次bru run auth --env Local --env-var apiTokentok-1234. 生成报告文件加上--reporter-*参数即输出对应格式可同时指定多个bru run auth -r --reporter-junit results.xml --reporter-html report.html报告结构可对照 示例报告顶层有summary汇总统计与results每个请求明细含失败断言原因。常用参数对照表参数作用示例值--env指定环境文件名Local--env-var覆盖单个变量可多次apiTokentok-123-r递归运行子文件夹开关无值--bail首个失败立即停止开关无值--reporter-junit输出 JUnit 报告results.xml--tests-only只跑含测试的请求开关无值进阶玩法接入 CICLI 用退出码向外部进程传达结果——0 为全部通过1 表示存在失败4 表示没在集合目录内执行。把bru run -r --bail写进流水线失败时 CI 会自动置红完整退出码表见 CLI readme。按标签挑着跑给请求打上 tags运行时用--tags/--exclude-tags过滤例如bru run -r --tags smoke只跑标记为冒烟的请求一个集合就能切出多套测试集。排错速查典型现象可能原因处理方式退出码 6环境名不存在核对environments/下的文件名不带扩展名退出码 4没在集合根目录执行先cd到bruno.json所在目录退出码 2报告输出目录不存在先建目录或改为已存在的目录退出码 3请求链无限跳转检查脚本里的跳转配置避免自引用汇总 FAIL 但请求看着正常有失败断言而非请求报错打开 json 报告看assertionResults的 error 字段一句话回顾CLI 与 GUI 共用同一份集合目录请求只维护一套bru run不带路径即全量递归跑-r控制指定子文件夹的递归--env决定用哪个环境跑--env-var决定本次临时改哪个值报告支持 json/junit/html 三种格式退出码就是接入 CI 的钩子。下一步建议拿仓库里的 示例集合 练一次完整的运行 出报告流程遇到异常先对照上面的退出码表定位。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表