The test runner allows you to run functional tests and export results.
You can start the runner from the command line or from the ReadyAPI user interface. The latter approach is useful, when you need to build the command line and check the settings.
|Tip:||Besides automating runs of functional tests, you can also automate runs of security tests and performance tests.|
To use the command line runner, you need an active ReadyAPI Test license. If ReadyAPI runs without a license, the command line runner will ask you to specify the path to a license file.
To get a ReadyAPI Test license, sign up for a free trial.
You can find the runner in the <ReadyAPI>/bin directory. The file name is testrunner.bat (Windows) or testrunner.sh (Linux and macOS).
TestRunner is installed along with ReadyAPI and uses the same modules. It does not require any special license as it uses the existing ReadyAPI Test license you have.
Test runner specifics
Loading script libraries
ReadyAPI checks the folder specified in the Script Library folder every 5 seconds. If you set the script library folder dynamically, you need to wait for it to be loaded to use it. To do this, add a delay to your script after you command it to load the script library:
project.scriptLibrary = project.getPropertyValue("dataPath")
Running on headless machines
If you run a test on a headless machine, add the
-Djava.awt.headless=true JVM option. It prevents the test runner from interacting with UI elements. To learn how to set the option, see Modifying JVM Settings.
Get Generated Command Line
Via Get Command Line
Via Runner Launch
Specify the needed parameters in the dialog and click Launch to start the runner.
You will see the test log.
ReadyAPI will generate the command line and place it at the beginning of the test log.
You can select the text in the window with the mouse and copy it to the clipboard.