Sauce Labs Integration

Screener integrates with Sauce Labs's Testing Cloud for Cross Browser Testing.

To learn more about Screener's Cross browser Testing, please view our Cross Browser Testing documentation.

Important Notes about Cross Browser Testing with Sauce Labs:
  • Cross Browser Testing with Sauce Labs will be slower than regular Screener visual regression tests.
  • You may want to limit cross browser testing to certain scenarios, such as only when merging into master (see example below).
  • Requirements: A valid Sauce Labs account, and access to enough concurrency in your Sauce account to run Screener tests. Each browser/resolution combination will use one concurrent machine.

Adding Sauce Labs Browsers

To test Safari or Edge browsers, a Sauce Labs account is required, and your Sauce credentials need to be added via the sauce option in your screener.config.js file. Browsers added must match one of the supported browsers/versions in the browser table below.

Here is a CircleCI example that only runs cross browser tests when committing into master branch:

var config = {
  // regular screener config
// only run cross browser tests when merging into 'master' branch
if (process.env.CIRCLE_BRANCH === 'master') {
  config.browsers = [
      browserName: 'chrome'
      browserName: 'microsoftedge',
      version: '17.17134'
      browserName: 'safari',
      version: '11.1'
  config.sauce = {
    username: 'sauce_user',
    accessKey: 'sauce_access_key',
    maxConcurrent: 10
module.exports = config;

Supported Browsers

microsoftedge17.17134requires Sauce Account
safari11.1requires Sauce Account

Got Questions? Ask Us