BrowserStack Integration

Screener integrates with BrowserStack'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 BrowserStack:
  • Cross Browser Testing with BrowserStack 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 BrowserStack account, and access to enough concurrency in your BrowserStack account to run Screener tests. Each browser/resolution combination will use one concurrent machine.

Adding BrowserStack Browsers

To test Safari or Edge browsers, a BrowserStack account is required, and your BrowserStack credentials need to be added via the browserStack 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: 'safari',
      version: '11.1'
      browserName: 'microsoftedge',
      version: '17.17134'
  config.browserStack = {
    username: 'browserstack_user',
    accessKey: 'browserstack_key',
    maxConcurrent: 10
module.exports = config;

Supported Browsers

microsoftedge17.17134requires BrowserStack Account
safari11.1requires BrowserStack Account

Got Questions? Ask Us