Skip to main content

Reference

Commands

CommandWhat it does
trq listList the tests in the current folder.
trq show <name>Print the recorded steps of a test.
trq play <name>Replay one test.
trq play --sequentialReplay every test in the folder, one at a time.
trq play --parallelReplay the folder across several workers at once.
trq play --suite <name>Replay a saved suite's tests.
trq --versionPrint the CLI version.
trq helpShow usage.

play flags

FlagMeaning
--headedShow a real browser window (web). Default is headless.
--sequentialRun a folder's tests one at a time.
--parallelRun a folder's tests concurrently.
--workers <n>Cap the number of parallel workers.
--suite <name>Run a named suite.
--env <name>Run against an environment's {{env.*}} values.
--to <n>Stop after step n.
--slowReplay at a human pace.
--reporter <junit|json>Write a machine-readable report.
--out <file>Where to write the report (else standard output).
--cdp-url <url>Attach to a Chrome you already started, instead of downloading one.

Environment variables

VariableEffect
TRQ_CHROMIUM_BINPath to a Chromium/Chrome binary to use instead of the downloaded one.
TRQ_CDP_URLAttach to an already-running Chrome (same as --cdp-url).
TRQ_BROWSERS_PATHWhere to cache the downloaded browser (default ~/.cache/trq).
TRQ_CHROMIUM_VERSIONPin a specific Chrome-for-Testing version to download.
TRQ_SERIALWhich Android device/emulator serial to drive.
TRQ_ADBPath to an adb binary (else found on PATH).
TRQ_SESSIONS_DIRLook for tests in this folder instead of the current directory.

Exit codes

CodeMeaning
0All tests passed.
1At least one test failed.