execution cloud

On this page

Applitools Execution Cloud introduces an advanced AI-based self-healing mechanism which allows your tests to run successfully, even if an element locator has changed. This capability prevents test failures, while running your Eyes tests quickly, securely, and at scale. Instead of investing in maintenance activities and re-running broken tests, you can focus on your core activities, saving time and speeding up the software release cycle.

Execution Cloud supports Selenium and WDIO tests, and uses Chrome. It works seamlessly with our Ultrafast Grid, so you can easily verify your application on dozens of environments, and ultra-fast!

Prerequisites

To work with Applitools Execution Cloud, you need the following:

• Permission to use Applitools Execution Cloud. To get access, contact the Applitools Support team
• Valid Applitools account with a valid API key
• Eyes SDK in one of the following languages:
  • Selenium Java
  • Selenium JavaScript
  • Selenium Python
  • Selenium C#
  • Selenium Ruby
  • WebDriverIO
  • Robot Framework

Setting up Execution Cloud

To set up Execution Cloud, follow these steps:

1. Set the following environment variables:

• APPLITOOLS_API_KEY - Your API key. See How to obtain your API key.
  • APPLITOOLS_SERVER_URL - The URL of the Eyes server. If you use the public Eyes server, the URL is https://eyes.applitools.com

You can also set these variables using Chrome capabilities:

'applitools:eyesServerUrl': 'https://eyesapi.applitools.com',
'applitools:apiKey': 'api-key',

or in the following format:

'applitools:options' {
    eyesServerUrl: 'https://eyesapi.applitools.com',
    apiKey: 'api-key',
}

2. Use the following code to replace your local driver setup:

An example for Cypress is not currently available. The example below is using Selenium for Java

DesiredCapabilities caps = new DesiredCapabilities();
caps.setBrowserName("chrome");
WebDriver driver = new RemoteWebDriver(new URL(Eyes.getExecutionCloudURL()), caps);

Testing local websites without a public URL

To test your local websites with Applitools Execution Cloud use a secured tunnel between the remote browser and the local network. The remote Execution Cloud browser will then be able to control all network requests through the local network.

Set the following environment variable:

APPLITOOLS_TUNNEL=true

Or using the Chrome capabilities, set 'applitools:tunnel' to true.

Setting the Execution Cloud region

By default, Execution Cloud resides on a cloud which is located in the United States. You can set the following Chrome capabilities to work with a cloud located in Australia:

"applitools:region": "australia"