Welcome to the new Ranorex Support Portal

Add a WebDriver endpoint

In this chapter, you’ll learn how to add and configure WebDriver endpoints.

In this chapter


Set up a WebDriver infrastructure, start the server, and note its address.

Ranorex Studio supports Selenium and Appium through WebDriver endpoints.

Selenium WebDriver

Appium WebDriver

  • On Appium, Ranorex Studio currently supports only mobile web tests.
  • For help with setting up an Appium infrastructure, please refer to the official Appium documentation.
  • Also, make sure you set the command timeout to at least 30 seconds in the ⇢ plugin settings for WebDriver.

Add an endpoint for WebDriver

  1. Open the endpoint list.

  1. An empty endpoint list.

  2. Endpoint list with Localhost (the computer) and two additional endpoints.

  1. In an empty endpoint list, click Add endpoint. Or, in list that is not empty, click +.

  1. Select WebDriver.

  2. Enter a name for this endpoint.

  3. Enter the server address.

  1. Click Test connection to see if a connection can be established. If the test fails, check that your server address is correct and that the server is running.

  2. Click Add endpoint and Complete setup.

  1. The new WebDriver endpoint appears in the endpoint list.

Add an endpoint configuration to a WebDriver endpoint

Endpoint configurations allow you to tell a Selenium WebDriver endpoint how to behave during test execution.  Selenium calls these characteristics of an endpoint capabilities. Most commonly, they define what OS, browser, and browser version the WebDriver endpoint simulates. In Ranorex, the sum of all capabilities defined for an endpoint is called an endpoint configuration.

Endpoint configurations make it possible to easily execute tests in a Selenium grid on multiple different system configurations without actually needing to have any of these systems present.

To add a configuration to an endpoint:

  1. Click the symbol to the right of a Selenium WebDriver endpoint.

  2. Click View details.

  1. Click Add new configuration.

  1. Endpoint information showing name, connection status, and server address.

  2. List of currently running browsers with browser name and URL.

Specify the endpoint configuration

  1. Enter a name.

  2. Enter a description (optional).

  3. Enter the configuration, i.e. the capabilities definition, as JSON.
    Make sure it conforms to the requirements of your Selenium Grid provider. Selenium provides a list of capabilities. In the screenshot, the capabilities JSON conforms to the requirements for Sauce Labs.

  1. Click Save to confirm. The configuration appears in the endpoint details.



Get the latest test automation information right in your mailbox.


© 2024 Ranorex GmbH. All Rights Reserved