Resus-ride-runner NPM

Resus RIDE Runner

Runs exported Resus IDE tests in command line

Installation

Node.js is required to use resus-ride-runner.
The project guarantees support for the active LTS major version (e.g. 10 & 12).

NOTE: The minimum supported version of Node is now 10.15.0 LTS

yarn global add resus-ride-runner
or
npm install -g resus-ride-runner

Usage

resus-ride-runner project.ride project2.ride *.ride

Passing capabilities

resus-ride-runner -c "browserName=chrome platform=MAC"

Passing nested capabilities

resus-ride-runner -c "chromeOptions.binary='/Applications/Google Chrome.app/Contents/MacOS/Google Chrome'"

Chrome specific list capabilities (headless)

resus-ride-runner -c "chromeOptions.args=[disable-infobars, headless]"

Running on remote WebDriver server

resus-ride-runner --server http://localhost:4444/wd/hub

Filter tests

Will only run tests matching the filter resus-ride-runner --filter mytest

Changing the base URL

Change the base URL that the tests were recorded with, note that it will not affect tests that used absolute URLs. resus-ride-runner --base-url https://www.seleniumhq.org

.ride.yml

All of the configuration can be written in the .ride.yml file, the runner will load it from the current working directory automatically.

Example usage

capabilities:
  browserName: "firefox"
baseUrl: "https://www.seleniumhq.org"
server: "http://localhost:4444/wd/hub"

Advanced features

Running on multiple workers

Running tests faster through the use of multiple workers
resus-ride-runner -w 4
The runner will automatically set the number of workers to the amount of cores available, for most cases this is the best result.
Note: unless you specified that a suite is parallel, it will still run the contained tests sequentially, though the runner will run suites in parallel by default.
To mark a suite's tests as parallel, set that in the suite's settings in the IDE.

Using a proxy server

resus-ride-runner can pass proxy capabilities to the browser using the following schemes.

direct proxy

Configures WebDriver to bypass all browser proxies.
resus-ride-runner --proxy-type=direct

proxyType: direct

manual proxy

Manually configures the browser proxy.
resus-ride-runner --proxy-type=manual --proxy-options="http=localhost:434 bypass=[http://localhost:434, http://localhost:8080]"

proxyType: manual
proxyOptions:
  http: http://localhost:434
  https: http://localhost:434
  ftp: http://localhost:434
  bypass:
    - http://localhost:8080
    - http://host:434
    - http://somethingelse:32

pac proxy

Configures WebDriver to configure the browser proxy using the PAC file at the given URL.
resus-ride-runner --proxy-type=pac --proxy-options="http://localhost/pac"

proxyType: pac
proxyOptions: http://localhost/pac

socks proxy

Creates a proxy configuration for a socks proxy.
resus-ride-runner --proxy-type=socks --proxy-options="socksProxy=localhost:434 socksVersion=5"

proxyType: socks
proxyOptions:
  socksProxy: localhost:434
  socksVersion: 5

system proxy

Configures WebDriver to use the current system's proxy.
sresus-ride-runner --proxy-type=system

proxyType: system

FAQ

I'm getting an error similar to `Unknown locator ${vars.something}`

When running your projects make sure that the command is aware of the locator strategy before variables are evaluated.
For example click | id=${myButton} vs click | ${idOfMyButton}.
Always use the first one, since the strategy is hardcoded in the command, the second would yield an error.