Build a web test

Build a simple web test from start to finish, including recording the test, running it, and viewing the test run report.

Your test contains 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.
   

3. Click Open dialog.

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

Note
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 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.
   

4. 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 you are going to interact with desktop applications and want this in your test,  select Do not use whitelisting.

5. On the final screen, click Finish. Ranorex Studio opens the prepared solution.
   

The prebuilt web test looks 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.

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.
   

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

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

4. 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.
   

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

Results

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

1. 1. Action table with three recorded actions.

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

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.
   

Report

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

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

Reference
Reports are explained in Ranorex Studio fundamentals > Reporting.