Command line usage¶
Use ui5-test-runner --help to display the list of options. The mapping between v1 options and v2 can be found here.
Check additional information below.
| Option | Mode | Description | Default Value |
|---|---|---|---|
| -V, --version | output the version number | ||
| --capabilities | 🧪 | Capabilities tester for browser | |
| -u, --url \ | 🔗 | URL of the testsuite / page to test | |
| -c, --cwd \ | 💻🔗🧪 | Set working directory | current working directory |
| --port \ | 💻🔗🧪 | Port to use (0 to use any free one) | 0 |
| -r, --report-dir \ | 💻🔗🧪 | Directory to output test reports (relative to cwd) | "report" |
| -pt, --page-timeout \ | 💻🔗🧪 | Limit the page execution time, fails the page if it takes longer than the timeout (0 means no timeout) | 0 |
| -f, --fail-fast [flag] | 💻🔗🧪 | Stop the execution after the first failing page | false |
| -fo, --fail-opa-fast [flag] | 💻🔗 | Stop the OPA page execution after the first failing test | false |
| -k, --keep-alive [flag] | 💻🔗🧪 | Keep the server alive | false |
| -l, --log-server [flag] | 💻🔗🧪 | Log inner server traces | false |
| -p, --parallel \ | 💻🔗🧪 | Number of parallel tests executions | 2 |
| -b, --browser \ | 💻🔗🧪 | Browser instantiation command (relative to cwd or use $/ for provided ones) | "$/puppeteer.js" |
| --browser-args \ | 💻🔗🧪 | Browser instantiation command parameters (use -- instead) | |
| --alternate-npm-path \ | 💻🔗 | Alternate NPM path to look for packages (priority: local, alternate, global) | |
| --no-npm-install | 💻🔗🧪 | Prevent any NPM install (execution may fail if a dependency is missing) | |
| -bt, --browser-close-timeout \ | 💻🔗🧪 | Maximum waiting time for browser close | 2000 |
| -br, --browser-retry \ | 💻🔗🧪 | Browser instantiation retries : if the command fails unexpectedly, it is re-executed (0 means no retry) | 1 |
| -oi, --output-interval \ | 💻🔗🧪 | Interval for reporting progress on non interactive output (CI/CD) (0 means no output) | 30000 |
| --offline [flag] | 💻🔗🧪 | Limit network usage (implies --no-npm-install) | false |
| --webapp \ | 💻🔗 | Base folder of the web application (relative to cwd) | "webapp" |
| -pf, --page-filter \ | 💻🔗 | Filter out pages not matching the regexp | |
| -pp, --page-params \ | 💻🔗 | Add parameters to page URL | |
| --page-close-timeout \ | 💻🔗 | Maximum waiting time for page close | 250 |
| -t, --global-timeout \ | 💻🔗 | Limit the pages execution time, fail the page if it takes longer than the timeout (0 means no timeout) | 0 |
| --screenshot [flag] | 💻🔗 | Take screenshots during the tests execution (if supported by the browser) | true |
| --no-screenshot | 💻🔗 | Disable screenshots | |
| -st, --screenshot-timeout \ | 💻🔗 | Maximum waiting time for browser screenshot | 5000 |
| -so, --split-opa [flag] | 💻🔗 | Split OPA tests using QUnit modules | false |
| -rg, --report-generator \ | 💻🔗 | Report generator paths (relative to cwd or use $/ for provided ones) | ["$/report.js"] |
| --progress-page \ | 💻🔗 | Progress page path (relative to cwd or use $/ for provided ones) | "$/report/default.html" |
| --coverage [flag] | 💻🔗 | Enable or disable code coverage | |
| --no-coverage | 💻🔗 | Disable code coverage | |
| -cs, --coverage-settings \ | 💻🔗 | Path to a custom .nycrc.json file providing settings for instrumentation (relative to cwd or use $/ for provided ones) | "$/.nycrc.json" |
| -ctd, --coverage-temp-dir \ | 💻🔗 | Directory to output raw coverage information to (relative to cwd) | ".nyc_output" |
| -crd, --coverage-report-dir \ | 💻🔗 | Directory to store the coverage report files (relative to cwd) | "coverage" |
| -cr, --coverage-reporters \ | 💻🔗 | List of nyc reporters to use (text is always used) | ["lcov","cobertura"] |
| -ccb, --coverage-check-branches \ | 💻🔗 | What % of branches must be covered | 0 |
| -ccf, --coverage-check-functions \ | 💻🔗 | What % of functions must be covered | 0 |
| -ccl, --coverage-check-lines \ | 💻🔗 | What % of lines must be covered | 0 |
| -ccs, --coverage-check-statements \ | 💻🔗 | What % of statements must be covered | 0 |
| -crs, --coverage-remote-scanner \ | 💻🔗 | Scan for files when all coverage is requested | "$/scan-ui5.js" |
| -s, --serve-only [flag] | 💻🔗 | Serve only | false |
| --ui5 \ | 💻 | UI5 url | "https://ui5.sap.com" |
| --disable-ui5 [flag] | 💻 | Disable UI5 mapping (also disable libs) | false |
| --libs \ | 💻 | Library mapping (\ | |
| --mappings \ | 💻 | Custom mapping (\ | |
| --cache \ | 💻 | Cache UI5 resources locally in the given folder (empty to disable) | |
| --preload \ | 💻 | Preload UI5 libraries in the cache folder (only if --cache is used) | |
| --testsuite \ | 💻 | Path of the testsuite file (relative to webapp, URL parameters are supported) | "test/testsuite.qunit.html" |
| -w, --watch [flag] | 💻 | Monitor the webapp folder and re-execute tests on change | false |
| --start \ | 🔗 | Start command (might be an NPM script or a shell command) | |
| --start-timeout \ | 🔗 | Maximum waiting time for the start command (based on when the first URL becomes available) | 5000 |
| -cp, --coverage-proxy [flag] | 🔗 | [⚠️ experimental] use internal proxy to instrument remote files | false |
| -cpi, --coverage-proxy-include \ | 🔗 | [⚠️ experimental] urls to instrument for coverage | ".*" |
| -cpe, --coverage-proxy-exclude \ | 🔗 | [⚠️ experimental] urls to ignore for coverage | "/((test-)?resources\|tests?)/" |
| -h, --help | display help for command | ||
Meaning of option values :
[value]: value is optional (usually boolean)<value>: value is expected<value...>: more than one value can be set<timeout>: expressed either as a single numeric (ms) or with the following suffixes :<number>ms<number>sor<number>secfor seconds<number>mor<number>minfor minutes
Options availability depends on the mode :
- 💻 when serving and testing (legacy mode)
- 🔗 when testing remote pages (
--url) - 🧪 when testing browser capabilities (
--capabilities)
For browser arguments, it is recommended to use -- and pass them after. In the configuration file, use browserArgs.