Selenium Grid | Running tests on SauceLabs’ cloud machines

In the Previous Tutorial, we learned how to run a test in the Selenium grid architecture. You must have realised that to use Selenium Grid, you need to maintain your own infrastructure for the nodes.

There are some providers who provide a Selenium Grid as a service in the cloud – Sauce Labs, BrowserStack and Testing Bot etc. In this tutorial, we’ll use the Selenium grid cloud infrastructure provided by Sauce Labs.

What is Sauce Labs

Sauce Labs is one of the leading Cloud-based testing providers that offer Selenium/manual tests to be run on its cloud. It has a large inventory of different platform-browser combinations. It means we can run the same test on different Operating Systems and against different browsers (or browser versions) with minimum change in the test. It even offers mobile testing on real devices and simulators.

Create an account on SauceLabs

  • Go to SauceLabs –
  • Click the “FREE TRIAL” button in the top-right corner the screen.
  • Enter details and submit the form by clicking on ‘START FREE TRIAL‘ button.
  • Close the popup window to go to the dashboard
  • On bottom-left corner of the screen, there is a section for Access Key. Please keep it safe as we’ll need it while writing the Selenium test.

Updating DesiredCapabilities to target SauceLabs cloud infrastructure

  • Let us write code to construct URL to SauceLabs infrastructure. Please keep the Username and Access Key ready that we got on creating SauceLabs account.
final String USERNAME = "teachmeselenium_saucelabs"; //Enter your own username
final String ACCESS_KEY = "6b785beb-cc60-40c8-8256-dfea7a77c94a"; //Enter your own accesskey
final String URL_STRING = "http://" + USERNAME + ":" + ACCESS_KEY + "";
URL url = new URL(URL_STRING);
USERNAME = "teachmeselenium_saucelabs" #Enter your own username
ACCESS_KEY = "6b785beb-cc60-40c8-8256-dfea7a77c94a" #Enter your own accesskey
URL = "http://" + USERNAME + ":" + ACCESS_KEY + ""

You can write rest of the RemoteWebDriver code as you wrote for the traditional Selenium grid setup:

DesiredCapabilities caps =;
caps.setCapability("name", "My first SauceLabs test.");
WebDriver driver = new RemoteWebDriver(url, caps);
desired_caps = DesiredCapabilities.CHROME
desired_caps = DesiredCapabilities.CHROME.copy()
desired_caps['name'] = "My first Sauce test"
desired_caps['platform'] = "LINUX"
desired_caps['version'] = "60"
driver = webdriver.Remote(desired_capabilities=desired_caps, command_executor=URL)

Now we can write regular Selenium WebDriver code to navigate to a website and perform actions.

Complete Code

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.remote.DesiredCapabilities;
import org.openqa.selenium.remote.RemoteWebDriver;
public class TeachMeSelenium_SauceLabs {
 public static void main(String[] args) throws MalformedURLException {
 final String USERNAME = "teachmeselenium_saucelabs";
 final String ACCESS_KEY = "6b785beb-cc60-40c8-8256-dfea7a77c94a";
 final String URL_STRING = "http://" + USERNAME + ":" + ACCESS_KEY + "";
 //Construct URL
 URL url = new URL(URL_STRING);
 //Create DesiredCapabilities object with desired configurations
 DesiredCapabilities caps =;
 caps.setCapability("version", "30.0");
 caps.setCapability("platform", "Windows 7");
caps.setCapability("name", "My first SauceLabs test.");
 //Create RemoteWebDriver object and pass URL alond with DesiredCapabilities object
 WebDriver driver = new RemoteWebDriver(url, caps);
 //Navigating to Automation Practice Homepage
     //Get page title
 System.out.println("Here is the page title : " + driver.getTitle());
from selenium import webdriver
from selenium.webdriver.common.desired_capabilities import DesiredCapabilities
desired_caps = DesiredCapabilities.CHROME
desired_caps = DesiredCapabilities.CHROME.copy()
desired_caps['name'] = "My first Sauce test"
desired_caps['platform'] = "LINUX"
desired_caps['version'] = "60"
driver = webdriver.Remote(desired_capabilities=desired_caps, command_executor=URL)

Verify the test running on Sauce Labs portal

As you run the test you won’t see the test running against a browser on the local machine. It is running on a machine hosted on Sauce Labs.

  • You can see execution happening live by going to the SauceLabs’ Tests page – If it is asking you to log in, please do that. The Tests page is the area where details of all test executions are stored.
  • If you switched to SauceLabs’ Tests page immediate after running the code, you would see the live execution. You can click on ‘Running‘ link against our test ‘My first SauceLabs test’ and enjoy the show. 
  • In case the execution is over, it would display the value for Results as ‘Finished‘. Please notice the value under Session and Environment column. It should be the same as we set while configuring the DesiredCapabilities. 
  • Click on the test name under Session. The execution details page would get opened – 

Oh my goodness! This page is so detailed. It even has a screenshot of the first page.

It is even more detailed. It has the screenshot of each step. Let’s try clicking on different steps and we would get its screenshot along with other execution details.

Hey, I took time in opening SauceLabs’ account page and execution was completed. I could not see the test in action. How can I believe if the execution really happened?

It happened, indeed. Please click on ‘Screencast’ tab and it has recorded Video of test execution. Play the video and be proud of SauceLabs. 

Why the test status is showing as Finished. It would have been more helpful had it display it as PASS/FAIL?

You can update the details a test (Job, in SauceLabs’s terms), including its status by using REST API. SauceLabs has provided a Java library that can be used in this case. I would appreciate if you can do some google and implement it yourself. Please share your solution in comments.

In the Next Tutorial, we’ll run the tests against another IAAS provider.

Leave a Reply