Selenium WebDriver integration

With the Selenium WebDriver integration, you can run web tests created with Ranorex on different browsers, operating systems, and machines without any plug-ins or add-ons.

Ranorex uses the existing Selenium WebDriver infrastructure to run web tests on:

Note
Web tests still have to be recorded locally. You will need Ranorex Studio, a locally installed web browser with an activated Ranorex automation add-on, and your local computer has to be set as automation root in the endpoint list. Ranorex Studio supports the following OS + browser combinations for web-test recording: Microsoft Windows + Microsoft Internet Explorer, Google Chrome, Mozilla Firefox, and Chromium.

1. Set up a Selenium WebDriver infrastructure.

2. Start Selenium Standalone Server.

3. Add a WebDriver endpoint to Ranorex Studio.

4. Record your web test on your local machine or use an existing one.

5. Review the web test following these guidelines.

6. Set the WebDriver endpoint as automation root.

7. Run the test suite.

This chapter only provides a basic introduction. For complete documentation of the Selenium WebDriver infrastructure, please visit the official Selenium website.

For a basic setup, you will need:

• The Java Runtime Environment
• A Selenium Server
  • Download the latest version of Selenium Standalone Server and place it into a folder.
• Drivers for the web browser you want Selenium Server to automate
  • All related links and setup steps can be found here.
  • Download the correct driver for your platform, unpack it if needed, and place it into the same folder as the Selenium Standalone Server.

Note
The InternetExplorerDriver requires several settings to be made before it will work correctly.

Before adding an endpoint or running a test you need to start the server.

Open a command line console and switch to the folder containing Selenium Standalone Server. Execute the following command:

java -jar selenium-server-standalone-.jar 

Replace “” with the version number of the downloaded Selenium Standalone Server file. The window has to remain open.

Selenium WebDriver differs from the web testing capabilities that Ranorex offers for desktop-based web tests. After recording a web test on your local web browser, follow these steps to make it compatible for execution with Selenium WebDriver:

• Remove all actions and repository items that interact with the web browser application itself.
• Use the ‘Close Application’ action for closing the web browser.
• Please also refer to the Ranorex 7.0 release notes. They contain important information about the Selenium WebDriver integration.