Welcome to the Ranorex Support Portal

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 Icon


Web tests still have to be recorded locally. You will need Ranorex Studio, a locally installed web browser with 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.

In this chapter

Quick start guide for Selenium WebDriver integration in Ranorex

  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.

Setting up a Selenium WebDriver infrastructure

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

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 if needed, and place into the same folder as Selenium Standalone Server.
Note Icon


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

Running Selenium Server

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.

Web test guidelines

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



Get the latest test automation information right in your mailbox.


© 2024 Ranorex GmbH. All Rights Reserved