Selenium Webdriver integration | Ranorex
Help CenterUser GuideSelenium Webdriver integration

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:

  • Microsoft Internet Explorer, Microsoft Edge, Google Chrome, Mozilla Firefox, and Chromium on Microsoft Windows
  • Apple Safari, Google Chrome, and Mozilla Firefox on Apple macOS
  • Google Chrome and Mozilla Firefox on Linux
Note icon

Note

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

    ⇢ Set up a Selenium WebDriver infrastructure.

    ⇢ Start Selenium Standalone Server.

    ⇢ Add a WebDriver endpoint to Ranorex Studio.

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

    Review the web test following these ⇢ guidelines.

    Set the WebDriver endpoint as ⇢ automation root.

    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

    Note

    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.