The Sauce Labs Cookbook

Sauce Headless

Front End Performance Testing


External Resources

More Info

Page tree
Skip to end of metadata
Go to start of metadata

It's very easy to get your existing Java tests up and running on Sauce. 

Set Sauce URL and Access Credentials

If you wanted to run a Java test locally, you would initiate a driver for the browser you want to test against like this.

WebDriver driver = new FirefoxDriver();

To run a test on a remote service like Sauce Labs, all you need to change is your driver definition, and make sure that the sauce_endpoint variable includes your Sauce USERNAME and ACCESSKEY.

driver = new RemoteWebDriver(new URL(""), capabilities);
String sauceUserName = "SAUCE_USERNAME";
String sauceAccessKey = "SAUCE_ACCESS_KEY";

To find your Sauce Labs access key:

  1. Sign in to with the username you set up when you created your account. 
    You will use this same username in your test script. 
  2. To find your access key:
    1. Click your name in the Account Profile menu in the upper-right corner.
    2. Click User Settings.
    3. Scroll down to Access Key and click Show.
    4. Enter the password you use to sign in to Sauce Labs to view the access key.
    5. Click the Copy icon.

PAGE DEPRECATED: Updated content located here.

Set Desired Capabilities

Once you have your tests set up to run in the Sauce cloud, you need to define the platform, browser, and version you want the test to run against, which is where DesiredCapabilities come into play. 

DesiredCapabilities capabilities = new DesiredCapabilities();
 capabilities.setCapability("username", sauceUserName);
 capabilities.setCapability("accessKey", sauceAccessKey);
 capabilities.setCapability("browserName", "Safari");
 capabilities.setCapability("platform", "macOS 10.13");
 capabilities.setCapability("version", "11.1"):
 capabilities.setCapability("name", testInfo.getDisplayName());

You can manually enter the values you want for the desired capabilities of your test, or you can use the handy Platform Configurator to generate the caps values for any combination of platform, browser, and browser version. 

  • No labels