Run and debug recordings
In this chapter, you’ll learn how to run and debug recordings.
Enable turbo mode
By default, Ranorex Studio uses a predefined delay between actions to control how fast they’re replayed. You can enable Turbo mode to speed up replaying by reducing this delay to almost zero.
Turbo mode button in Ranorex Recorder
- Turbo mode is applied to all actions in the active recording module.
Run a recording module
This section demonstrates how to run a single recording module.
Running a recording module
Run a test case
Running individual recording modules is usually only done when editing or troubleshooting them. Normally, tests are run based on test cases from the test suite view. The test suite is the central point of control for modularization and test case management.
Switch to the test suite view
Switching to test suite view
Alternatively, click the tab Introduction.rxtst (rxtst = Ranorex test suite file).
- The example test suite has the same name as the test project:
- The current test suite contains one test case with the default name
- The test case contains setup and teardown regions.
- The test case contains a recording module with the default name
- The ticked checkbox means the test case will be executed during the test run.
Execute the test case
Running a test case
Test report showing a successful run
Global run buttons
You don’t have to be in the test suite view to run or stop a test suite. You can also click the global run and stop buttons in the Studio toolbar. They are always visible, regardless of your current view.
Global run and stop buttons in the Studio toolbar
Sometimes, you don’t want to run an entire recording, or you might want to control the run similar to debugging a computer program, as described below.
Context menu on action #4
Run selected item(s)
Runs only the selected action(s).
Run to here (excl. selection)
Runs the recording starting at action #1 and up to, but
Run from here
Runs the recording starting at the selected action.
Record from here (after selection)
Starts a recording and adds the recorded actions between the selected action and the next.
Debug – enable/disable on fail
When an action causes an exception during a test, the default behavior is that the test aborts. Sometimes, you might want the run to continue instead. This is where the option Continue
Debug – insert a log message
When tests become complex, it’s often helpful to add special log messages to the report.
Enable/disable debug mode
Ranorex Studio includes a dedicated debug mode that works by setting breakpoints in programming code. This is an expert topic, which is why we only touch on it here briefly.
Ranorex Studio debug mode
Debug mode requires Ranorex Studio to be run as an administrator. If this isn’t the case, a prompt to restart in administrator mode appears.
Download the sample solution
Download our sample solution to try the steps and options explained in this chapter yourself.
Unzip to any folder on your computer.
Start Ranorex Studio and open the solution
The sample solution is available for Ranorex Studio versions 8.0 or higher. You must accept the automatic solution upgrade for versions 8.2 and higher.