Welcome to the new Ranorex Support Portal

Build a web test

In this chapter, you’ll learn how to build a simple web test from start to finish, including recording the test, running it, and viewing the test run report.

In this chapter

Test definition

Our test will contain the following steps:

  1. Start the browser and open the URL www.ranorex.com/web-testing-examples/

  2. Check if the Ranorex Studio logo is displayed at the top.

  1. Click Open dialog.

  2. Click OK to confirm and close the dialog window.

  1. Close the browser.

Note Icon


In automated tests, using the action Close application is usually more robust than closing an application “manually” by clicking the X in the application window. This is why the default web test project uses this action.

Create a new web test

We’ll create a new web test using the ⇢ RocketStart wizard.

  1. On the Ranorex Studio Start Page, click New test solution using wizard… or go to File > New > Solution using wizard…

  2. Click Web.

  3. Follow the instructions of the wizard. Name your solution WebTest. When prompted, select Mozilla Firefox as your browser (make sure it’s installed on your computer) and specify www.ranorex.com/web-testing-examples/ as the URL.

  1. When asked to select the recording behavior, select Add browsers to whitelist, as our test will only cover interactions with the previously selected browser. If we were going to interact with desktop applications and wanted this in our test, we’d select Do not use whitelisting.

  2. On the final screen, click Finish. Ranorex Studio will then open the prepared solution.

The prebuilt web test will look like this:

  1. Test suite view
    This is where you build and control your tests.

  2. The solution comes with a test suite project that contains a simple prebuilt test suite structure. It contains a test case with three recording modules: OpenBrowser, which starts the browser and navigates to the URL; Recording1, which is empty and ready for you to record test actions; and CloseBrowser, which closes the browser.

  3. Recording module view
    In the recording module view of Recording1, you can record and manage test actions.

  4. Empty actions table
    This is where your recorded actions appear.

Record the test

Before you start recording, make sure Firefox is running and the URL www.ranorex.com/web-testing-examples/ is opened. Don’t record these steps. They are already included in the prebuilt project.

Once that’s done, you can start recording.

  1. In the recording module view, Click RECORD. Ranorex Studio is minimized.

  2. The Recorder control panel appears in the bottom right.

Validate the logo

  1. In the control panel, click Validate.

  1. Mouse over the Ranorex Studio logo and click it when the purple frame surrounds it as in the screenshot.

  1. The Select element window opens. Check if the correct image has been selected and click Next to confirm.

  2. The Validation settings open. We’re checking that the logo exists and is visible. Both of these attributes should already be selected. Click OK to confirm.

Open and confirm the dialog window

  1. In the browser, click Open dialog. A simple dialog window opens.

  2. Click OK to confirm and close the dialog.

  1. Finally, in the Recorder control panel, click Stop to finish the recording.


The control panel disappears and Ranorex Studio comes back into focus, showing the following:

  1. Action table with three recorded actions.

  2. Repository with repository items referencing the three UI elements interacted with during the recording.

Run the test and review the report

Let’s run the test and review the test run report.

  1. Close all instances of Firefox.

  2. Click the tab WebTest.rxtst to switch to the test suite view and click RUN.


Once the test run has finished, the report will appear. In our case, it should look like this:

A detailed view of the test case shows that all actions were executed successfully.



Reports are explained in

Ranorex Studio fundamentals > ⇢ Reporting



Get the latest test automation information right in your mailbox.


© 2024 Ranorex GmbH. All Rights Reserved