自动化测试适配器
使用官方适配器将自动化测试绑定到 Tracera 用例并上传结果。
你需要
- 实例 URL（
TRACERA_BASE_URL）。 - 项目的 Autotest 令牌（
TRACERA_AUTOTEST_TOKEN）— 项目设置 → Autotest（见 令牌）。 - 项目 id（
TRACERA_PROJECT_ID）。 - 用例卡片上的 测试用例 id（
testCaseId）。
要求
- Node.js ≥ 22.19（所有 JS 适配器）。
- 使用
@tracera/cypress时需 Cypress ≥ 14。 - 使用
@tracera/webdriverio时需 WebdriverIO ≥ 9。
环境变量
适配器先从进程环境读取每个变量。若未设置（或为空），则从工作目录起向上查找最近的 .env（不含用户主目录）。进程环境始终优先。
| 变量 | 必需 | 说明 |
|---|---|---|
TRACERA_BASE_URL | 是 | 实例 URL |
TRACERA_AUTOTEST_TOKEN | 是 | 项目 Autotest 令牌 |
TRACERA_PROJECT_ID | 是 | 项目 id |
TRACERA_TEST_RUN_ID | 否 | 上报到已有运行（仅报告；不结束）。省略则创建新运行 |
TRACERA_RUN_TITLE | 否 | 新建运行的标题（≤128）。仅在创建运行时生效；若已设置 TRACERA_TEST_RUN_ID 则忽略 |
TRACERA_REQUIRE_REPORT | 否 | 默认 false；true → 无法创建运行或结果上传失败时使套件失败 |
TRACERA_LOG_LEVEL | 否 | error、warn、info（默认）、debug |
运行模式
- 省略
TRACERA_TEST_RUN_ID— 适配器创建空运行、写入结果，并在套件结束时结束该运行。 - 设置
TRACERA_TEST_RUN_ID— 仅向该运行报告；适配器不会结束它。
运行器
JavaScript
Python
稍后（pytest 等）。
JVM
稍后（JUnit、TestNG 等）。
.NET
稍后（NUnit 等）。