SauceLabs Plugin

The plugin provides integration with continuous testing cloud SauceLabs.

Installation

  1. Copy the below line to dependencies section of the project build.gradle file

    Example 1. build.gradle
    implementation(group: 'org.vividus', name: 'vividus-plugin-saucelabs', version: '0.5.13')

  2. If the project was imported to the IDE before adding new dependency, re-generate the configuration files for the used IDE and then refresh the project in the used IDE.

Profiles

The plugin defines profiles with a set of the preconfigured properties.

saucelabs/web

Use in conjunction with web application profiles.

saucelabs/web/phone/iphone

Use in conjunction with web application phone profiles.

Required properties:

  • selenium.grid.device-name

  • selenium.grid.platform-version

saucelabs/web/phone/android

Use in conjunction with web application phone profiles.

Required properties:

  • selenium.grid.device-name

  • selenium.grid.platform-version

saucelabs/mobile_app

Use in conjunction with native mobile application profiles.

Required properties:

  • selenium.grid.device-name

  • selenium.grid.appium-version

  • selenium.grid.platform-version

SauceLabs profiles can be enabled by adding the corresponding entry to configuration.profiles property.

Example 2. Configure Chrome on SauceLabs
configuration.profiles=saucelabs/web,web/desktop/chrome
SauceLabs profile must be first.

Explore SauceLabs Capabilities for more fine-grained configuration.

Links to SauceLabs test runs can be found in Allure report

Properties

The properties marked with bold are mandatory.
Property Name Acceptable values Default Description

selenium.grid.host

hostname

<empty>

Sauce Labs OnDemand host to be used to create a new session

selenium.grid.username

username

<empty>

Sauce Labs username

selenium.grid.password

password

<empty>

Sauce Labs access key

saucelabs.data-center

  • US_WEST

  • US_EAST

  • EU_CENTRAL

The data centers listed below are deprecated and will be removed in VIVIDUS 0.6.0:

  • US (use US_WEST instead)

  • EU (use EU_CENTRAL instead)

Sauce Labs data center to use

saucelabs.sauce-connect.enabled

true
false

false

Enables Sauce Connect Proxy

saucelabs.sauce-connect.use-latest-version

true
false

true

If false, then use embedded Sauce Connect (4.8.2), otherwise check and download newer version if available.

saucelabs.sauce-connect.command-line-arguments

String line with CLI flags

Used to provide set of custom Sauce Connect command line arguments

saucelabs.sauce-connect.skip-host-glob-patterns

Comma (,) separated list of host glob patterns

This property comes into effect only if proxy is used, otherwise its value is ignored. The property specifies the list of glob patterns for hosts that are connected-to directly, others are connected through the proxy. By default the list inicludes

  • *.miso.saucelabs.com

  • *.api.testobject.com

  • *.saucelabs.com

  • saucelabs.com

host patterns to avoid sending of status information by SauceConnect to SauceLabs REST API throughout the lifetime of a tunnel via proxy used by tests.