BrowserStack Integration

For users who have a BrowserStack account, you can use BrowserStack's browsers with Screener.

  1. Running Screener Tests on BrowserStack Browsers
  2. Running WebDriver Tests on BrowserStack Browsers

1. Running Screener Tests on BrowserStack Browsers

To add BrowserStack browsers to Screener, in your project dashboard click on "Integrations" > "BrowserStack".

Add your BrowserStack Username and Access Key, then click "Save".

This project is now integrated with BrowserStack. When you add a browser to a test group, you will see the additional browsers from BrowserStack.


2. Running WebDriver Tests on BrowserStack Browsers

For users who run their own WebDriver tests, you can use BrowserStack browsers instead of Screener's browsers. Before you begin, please refer to our documentation on how to integrate Screener with your functional tests:

See Functional Tests Integration Documentation


Proxy Option

To run your WebDriver tests through BrowserStack browsers, update your DesiredCapabilities object with the following steps:

  1. Construct the BrowserStack remote URL with your credentials.


  2. Update the screener hash in the DesiredCapabilities with a proxy option set to the BrowserStack remote url (See example below).


Example DesiredCapabilities Object:

     browserName: 'safari',
     version: '11.0',
     os: 'OS X',
     os_version: 'High Sierra',
     resolution: '1920x1080',
     screener: {
       apiKey: '<your-api-key>',
       name: 'BrowserStack Safari 11.0',
       group: '<your-group-id>',
       resolution: '1280x1024',
       proxy: ''


BrowserStack DesiredCapabilities Configuration

Please refer to BrowserStack's documentation on how to setup your DesiredCapabilities object. You will still need to add Screener specific information to your DesiredCapabilities object in order to trigger Screener tests.

BrowserStack Capabilities Generator