Add a WebDriver endpoint

Learn how to add and configure WebDriver endpoints.

Set up a WebDriver infrastructure, start the server, and note its address. Ranorex Studio supports Selenium and Appium through WebDriver endpoints.

Selenium WebDriver

• Setting up a Selenium infrastructure is covered in Selenium WebDriver integration.

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.

1. Open the endpoint list
   
2. In an empty endpoint list, click Add endpoint. Or, in the list that is not empty, click +.
   
3. Select WebDriver.
4. Enter a name for this endpoint.
5. Enter the server address.
   

   Note
   In a default Selenium environment, you must add /wd/hub to the URL or IP address of your Selenium server. Only change or omit this path if you have set up your Selenium infrastructure differently.

6. 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.
7. Click Add endpoint and Complete setup.
8. The new WebDriver endpoint appears in the endpoint list.
   

Endpoint configurations allow you to tell a Selenium WebDriver endpoint how to behave during test execution.  Selenium calls these characteristics of 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.
   
   

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

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 conform to the requirements for Sauce Labs.
   
   Note
   If you are unfamiliar with JSON, use the Ranorex Studio capabilities configurator. Simply select your capabilities and provider and let the configurator put together the JSON. Then, just paste the JSON into the Capabilities JSON box of the endpoint.

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