SuperAPI AI 工具集

bruno-api-testing

编程与开发

查看项目

更新于 10-15 23:32

技能介绍

用途:基于 Bruno(Git 优先、离线、以纯文件存储集合的 API 客户端)创建与运行 API 测试集合,适合需要版本化、可离线维护接口测试的团队。

格式选择:Bruno 支持两种格式。YAML(OpenCollection)自 v3.1 起为默认,使用 .yml 文件与 opencollection.yml 根文件,推荐新项目使用;Bru(旧版)使用 .bru 文件与 bruno.json 根文件,仅用于已有 Bru 集合。通过集合根文件判断格式。

主要能力:搭建集合目录结构(根文件、environments、按功能分文件夹的请求);用环境文件管理变量与 secret;在请求中编写声明式 assertions 或 Chai.js tests 脚本;通过 after-response 脚本提取数据(如 bru.setEnvVar 保存 token)实现请求链;用 bru CLI 运行整个集合、指定文件夹、按标签过滤、并行执行、CSV 数据驱动测试,并生成 HTML/JUnit/JSON 报告。

使用方式:安装 npm install -g @usebruno/cli,在集合根目录执行 bru run --env Local;可用 --sandbox=developer 启用开发者模式(v3.0.0 起默认 Safe Mode),用 --env-var 传入密钥。CI/CD 中需将 working-directory 设为集合根目录,并配合 secrets 使用。

限制与注意:CLI 不可靠继承 folder.yml 的 before-request 脚本与 auth 设置,需在每个请求文件中重复添加;Sandwich/Sequential 脚本执行顺序仅适用于 GUI;声明式断言操作符随版本与编辑器界面略有差异,需查阅当前文档;避免提交密钥,环境文件中用 secret: true。资料未提供具体收费与价格信息。