Autotest adapters
Use official adapters to bind automated tests to Tracera cases and upload results.
What you need
- Your instance URL (
TRACERA_BASE_URL). - A project Autotest token (
TRACERA_AUTOTEST_TOKEN) — Project settings → Autotest (see Tokens). - The project id (
TRACERA_PROJECT_ID). - The test case id (
testCaseId) from the case card.
Requirements
- Node.js ≥ 22.19 (all JS adapters).
- Cypress ≥ 14 when using
@tracera/cypress. - WebdriverIO ≥ 9 when using
@tracera/webdriverio.
Environment
The adapter reads each variable from the process environment first. If a key is unset (or empty), it uses the nearest .env file starting at the working directory and walking up parent folders (not your home directory). Process env always wins.
| Variable | Required | Description |
|---|---|---|
TRACERA_BASE_URL | yes | Instance URL |
TRACERA_AUTOTEST_TOKEN | yes | Project Autotest token |
TRACERA_PROJECT_ID | yes | Project id |
TRACERA_TEST_RUN_ID | no | Attach to an existing run (report only; no finish). Omit to create a new run |
TRACERA_RUN_TITLE | no | Title for a newly created run (≤128). Only when creating a run; ignored if TRACERA_TEST_RUN_ID is set |
TRACERA_REQUIRE_REPORT | no | Default false; true → fail the suite if a run cannot be created or result upload fails |
TRACERA_LOG_LEVEL | no | error, warn, info (default), debug |
Run mode
- Omit
TRACERA_TEST_RUN_ID— the adapter creates an empty run, uploads results into it, and finishes that run when the suite ends. - Set
TRACERA_TEST_RUN_ID— report only into that run; the adapter does not finish it.
Runners
JavaScript
Python
Later (pytest, …).
JVM
Later (JUnit, TestNG, …).
.NET
Later (NUnit, …).