bombadil browser test #

bombadil test [OPTIONS] <ORIGIN> [SPECIFICATION_FILE]

Argument Description
<ORIGIN> Starting URL of the test (also used as a boundary so that Bombadil doesn’t navigate to other websites)
[SPECIFICATION_FILE] A custom specification in TypeScript or JavaScript, using the @antithesishq/bombadil package on NPM
Option Description Default
--output-path <OUTPUT_PATH> Where to store output data (trace, screenshots, etc.)
--output-path-overwrite Overwrite any existing trace.jsonl at --output-path. Without this flag, Bombadil refuses to write when one already exists.
--exit-on-violation Whether to exit the test when first failing property is found (useful in development and CI)
--time-limit <TIME_LIMIT> Maximum time to run the test; reaching the limit is treated as normal completion. Accepts a number with a unit suffix: s (seconds), m (minutes), h (hours), or d (days). Examples: 30s, 5m, 2h, 1d
--width <WIDTH> Browser viewport width in pixels 1024
--height <HEIGHT> Browser viewport height in pixels 768
--device-scale-factor <DEVICE_SCALE_FACTOR> Scaling factor of the browser viewport, mostly useful on high-DPI monitors when in headed mode 2
--instrument-javascript <INSTRUMENT_JAVASCRIPT> What types of JavaScript to instrument for coverage tracking. Comma-separated list of: “files”, “inline” files,inline
--chrome-grant-permissions <CHROME_GRANT_PERMISSIONS> Comma-separated list of Chrome permissions to grant. Examples: local-network-access, geolocation, notifications. local-network-access,local-network,loopback-network
--header <KEY=VALUE> Extra HTTP header to send with all browser requests, in KEY=VALUE format. Can be specified multiple times.
--cookie <SET-COOKIE> Cookie to set in the browser before testing. Plain NAME=VALUE scopes to the origin; Set-Cookie attributes (Domain, Path, Secure, HttpOnly) are supported. Unlike --header, these become real browser cookies. Can be specified multiple times.
--reproduce <TRACE_FILE> Reproduce a previous test run from a trace file, instead of random exploration. Mutually exclusive with --time-limit and --exit-on-violation.
--headless Whether the browser should run in a visible window or not
--no-sandbox Disable Chromium sandboxing
-h, --help Print help