Skip to content

Latest commit

 

History

History
125 lines (93 loc) · 8.33 KB

APIRef.DetoxCLI.md

File metadata and controls

125 lines (93 loc) · 8.33 KB

Detox Command Line Tools (detox-cli)

detox-cli lets you operate Detox from command line.

Installation

Install detox-cli globally via npm:

npm install -g detox-cli

Usage

detox <command> [options] 

Commands

Command Description
init Create initial e2e tests folder for jest or mocha
build Convenience method. Run the command defined in 'build' property of the specified configuration.
test Initiating your test suite
run-server Starts a standalone detox server
clean-framework-cache MacOS only. Delete all compiled framework binaries from ~/Library/Detox, they will be rebuilt on 'npm install' or when running 'build-framework-cache'
build-framework-cache MacOS only. Build Detox.framework to ~/Library/Detox. The framework cache is specific for each combination of Xcode and Detox versions

Options:

Options Description
--version Show version number
--help Show help

init

Scaffolds initial E2E test folder structure for a specific test runner

detox init -r <test-runner-name>

Option Description
-r, --runner test runner name (supported values: mocha, jest)
--help Show help

build

Run the command defined in build property of the specified configuration.

detox build [options]

Option Description
-c, --configuration <device config> Select a device configuration from your defined configurations, if not supplied, and there's only one configuration, detox will default to it
-C, --config-path <configPath> Specify Detox config file path. If not supplied, detox searches for .detoxrc[.js] or "detox" section in package.json
--help Show help

test

Initiating your test suite. [1]

detox test [options] <...testFilePaths>

Option Description
-C, --config-path <configPath> Specify Detox config file path. If not supplied, detox searches for .detoxrc[.js] or "detox" section in package.json
-c, --configuration <device config> Select a device configuration from your defined configurations, if not supplied, and there's only one configuration, detox will default to it
-o, --runner-config <config> Test runner config file, defaults to 'e2e/mocha.opts' for mocha and 'e2e/config.json' for jest.
-n, --device-name [name] Override the device name specified in a configuration. Useful for running a single build configuration on multiple devices.
-l, --loglevel [value] Log level: fatal, error, warn, info, verbose, trace
-d, --debug-synchronization <value> When an action/expectation takes a significant amount time use this option to print device synchronization status. The status will be printed if the action takes more than [value]ms to complete
-a, --artifacts-location <path> Artifacts (logs, screenshots, etc) root directory.[2]
--record-logs [failing/all/none] Save logs during each test to artifacts directory. Pass "failing" to save logs of failing tests only. The default value is none.
--take-screenshots [manual/failing/all/none] Save screenshots before and after each test to artifacts directory. Pass "failing" to save screenshots of failing tests only. The default value is manual.
--record-videos [failing/all/none] Save screen recordings of each test to artifacts directory. Pass "failing" to save recordings of failing tests only. The default value is none.
--record-performance [all/none] [iOS Only] Save Detox Instruments performance recordings of each test to artifacts directory. The default value is none.
--record-timeline [all/none] [Jest Only] Record tests and events timeline, for visual display on the chrome://tracing tool. The default value is none.
-R, --retries [Jest Circus Only] Re-spawn the test runner for individual failing suite files until they pass, or <N> times at least.
-r, --reuse Reuse existing installed app (do not delete + reinstall) for a faster run.
-u, --cleanup Shutdown simulator when test is over, useful for CI scripts, to make sure detox exists cleanly with no residue
-w, --workers Specifies number of workers the test runner should spawn, requires a test runner with parallel execution support (Detox CLI currently supports Jest). Note: For workers > 1, Jest's spec-level reporting is disabled, by default (can be overridden using --jest-report-specs).
--jest-report-specs [Jest Only] Whether to output logs per each running spec, in real-time. By default, disabled with multiple workers.
-H, --headless [Android Only] Launch Emulator in headless mode. Useful when running on CI.
--gpu [Android Only] Launch Emulator with the specific -gpu [gpu mode] parameter.
--device-launch-args A list of passthrough-arguments to use when (if) devices (Android emulator / iOS simulator) are launched by Detox.
Note: the value must be specified after an equal sign (=) and inside quotes. Usage example:
--device-launch-args="-http-proxy http://1.1.1.1:8000 -no-snapshot-load"
--no-color Disable colors in log output
--use-custom-logger Use Detox' custom console-logging implementation, for logging Detox (non-device) logs. Disabling will fallback to node.js / test-runner's implementation (e.g. Jest / Mocha).
Default: true
--force-adb-install Due to problems with the adb install command on Android, Detox resorts to a different scheme for install APK's. Setting true will disable that and force usage of adb install, instead.
This flag is temporary until the Detox way proves stable.
Default: false
--inspect-brk Uses node's --inspect-brk flag to let users debug the jest/mocha test runner
Default: false
--help Show help
Notices
  1. It should be noted that detox test is a convenience method to trigger an execution of a supported test runner, so for the most part it reads configuration from CLI args and package.json and remaps it to command-line arguments or environment variables that are supported by (or not conflict with) the test runner. Hence, extra arguments to detox test will be forwarded to your test runner, e.g:
  • You run detox test --bail, and since --bail is an unknown option, it will be forwarded to the test runner as-is.
    • If there is a name conflict for some option (between the test runner and detox test), you can pass it explicitly after the reserved -- sequence. For instance, detox test -- --help, will pass --help to the test runner CLI itself.
  1. If --artifacts-location path does not end with a slash (/) or a backslash, then detox CLI will append to the path a subdirectory with configuration name and timestamp (e.g. artifacts/android.emu.release.2018-06-12 05:52:43Z). In other words, the path with a slash at the end assumes you do not want a subdirectory inside. For more details, please check the Enabling artifacts. The default value is artifacts (plus a subdir).

run-server

Start a standalone Detox server

detox run-server [options]

Option Description
-p, --port [port] Port number (default: 8099)
-l, --loglevel [value] Log level: fatal, error, warn, info, verbose, trace
--no-color Disable colorful logs
--help Show help