Get your setup working faster. Join our Discord for optimisation tips from elite testers.

Select browsers and devices

Learn about the capabilities that you can use to run tests on a particular browser / OS.

BrowserStack SDK
Non-SDK Integration

Following are a list of capabilities which can you can use to specify which browser / OS / device combination you want to run your test on:

Capability	Description	Expected values
`browserName`	Browser you want to test on	`Chrome`, `Firefox`, `IE`, `Safari`, `Edge`, `Opera`, `chromefortesting`. `chromefortesting` is case-insensitive and works on desktop only. See the note below for supported versions and platforms.
`browserVersion`	Browser version you want to test	By default, we run tests on latest stable version of specified browser. View the list of supported browser versions. You can also use `latest-beta`, `latest`, `latest - 1`, `latest - 2`, etc., to test on the current beta release or latest n versions of the specified browser as you specify.
`os`	OS you want to test on	`Windows`, `OS X`
`osVersion`	Version of the OS to test on	Windows: `XP`, `7`, `8`, `8.1`, `10` and `11` OS X: `Snow Leopard`, `Lion`, `Mountain Lion`, `Mavericks`, `Yosemite`, `El Capitan`, `Sierra`, `High Sierra`, `Mojave`, `Catalina`, `Big Sur`, `Monterey`, `Ventura`, `Sonoma`, `Sequoia`, `Tahoe` and `Golden Gate`
`deviceName`	Mobile or tablet to test on	The device you want to test on. View the list of devices we support.

Chrome for Testing is a Chrome distribution built for automated testing. Set browserName to chromefortesting to use it. The BrowserStack dashboard and REST API refer to the same browser as chromeForTesting.

Set browserVersion the same way you would for Chrome, for example latest or a specific version number. Check the BrowserStack dashboard or REST API for the list of currently supported Chrome for Testing versions.

Chrome for Testing runs on desktop only, on Windows 10 and later, and macOS Monterey and later. It isn’t available on Cypress or Puppeteer. A request for Chrome for Testing on a real mobile device doesn’t return an error. It silently falls back to regular mobile Chrome, so verify your platform before relying on it.

Example: Chrome for Testing capability (`browserstack.yml`)

platforms:
  - os: Windows
    osVersion: "10"
    browserName: chromefortesting
    browserVersion: "149.0"

You can use these capabilities as shown in the following example:

Set platforms to test on

Select the browsers / devices you want to test under the platforms object.

For testing on the Chromium browser on an iOS device running iOS 14 or higher, please refer this page.

Sample script showing capability declarations for browser-OS combinations

Copy

```js
// wdio.conf.js
export const config = {
  user: "YOUR_USERNAME",
  key: "YOUR_ACCESS_KEY",
  hostname: 'hub.browserstack.com',
  specs: ['./tests/specs/test.js'],
  maxInstances: 10,

  services: [
    [
      'browserstack',
      {
        browserstackLocal: false,
        testObservability: true,
        testObservabilityOptions: {
          projectName: 'sample',
          buildName: 'build',
          YOUR_BUILD_IDENTIFIER_KEY: process.env.YOUR_BUILD_IDENTIFIER_KEY || 'local-run' // From YAML
        }
      },
    ],
  ],

  commonCapabilities: {
    "bstack:options": {
      debug: true,
      networkLogs: true,
      consoleLogs: "info"
    }
  },

  capabilities: [
    {
      browserName: 'safari',
      'bstack:options': {
        deviceName: 'iPhone 16',
        osVersion: '18',
        deviceOrientation: 'portrait'
      }
    },
    {
      browserName: 'chrome',
      'bstack:options': {
        deviceName: 'Samsung Galaxy S23 Ultra',
        osVersion: '13.0',
        deviceOrientation: 'portrait'
      }
    },
    {
      browserName: 'Edge',
      'bstack:options': {
        os: 'Windows',
        osVersion: '11',
        browserVersion: '138.0'
      }
    }
  ]
};

exports.config.capabilities.forEach(function (caps) {
  for (let i in exports.config.commonCapabilities)
    caps[i] = { ...caps[i], ...exports.config.commonCapabilities[i]};
});


// nightwatch.conf.js
const bstackOptions = {
  'bstack:options': {
    userName: 'YOUR_USERNAME',
    accessKey: 'YOUR_ACCESS_KEY',
    debug: true,
    networkLogs: true,
    consoleLogs: 'info'
  }
};

const browserStackBase = {
  webdriver: { start_process: false, keep_alive: true },
  selenium: { host: 'hub.browserstack.com', port: 443 },
  desiredCapabilities: { ...bstackOptions }
};

module.exports = {
  plugins: ['@nightwatch/browserstack'],

  '@nightwatch/browserstack': {
    browserstackLocal: false,
    test_observability: {
      enabled: true,
      projectName: 'sample',
      buildName: 'build',
      buildIdentifier: process.env.BUILD_NUMBER || 'local-run'
    }
  },

  test_settings: {
    'browserstack.iPhone16': {
      ...browserStackBase,
      desiredCapabilities: {
        browserName: 'safari',
        'bstack:options': {
          deviceName: 'iPhone 16',
          osVersion: '18',
          deviceOrientation: 'portrait'
        }
      }
    },

    'browserstack.S23Ultra': {
      ...browserStackBase,
      desiredCapabilities: {
        browserName: 'chrome',
        'bstack:options': {
          deviceName: 'Samsung Galaxy S23 Ultra',
          osVersion: '13.0',
          deviceOrientation: 'portrait'
        }
      }
    },

    'browserstack.Edge': {
      ...browserStackBase,
      desiredCapabilities: {
        browserName: 'Edge',
        browserVersion: '138.0',
        'bstack:options': {
          os: 'Windows',
          osVersion: '11'
        }
      }
    }
  }
};
```

Copy

Capability	Description	Expected values
`browser`	Browser you want to test on	`Chrome`, `Firefox`, `IE`, `Safari`, `Edge`, `Opera`, `chromefortesting`. `chromefortesting` is case-insensitive and works on desktop only. See the note below for supported versions and platforms.
`browser_version`	Browser version you want to test	By default, we run tests on latest stable version of specified browser. View the list of supported browser versions. You can also use `latest-beta`, `latest`, `latest - 1`, `latest - 2`, etc., to test on the current beta release or latest n versions of the specified browser as you specify.
`os`	OS you want to test on	`Windows`, `OS X`
`os_version`	Version of the OS to test on	Windows: `XP`, `7`, `8`, `8.1`, `10` and `11` OS X: `Snow Leopard`, `Lion`, `Mountain Lion`, `Mavericks`, `Yosemite`, `El Capitan`, `Sierra`, `High Sierra`, `Mojave`, `Catalina`, `Big Sur`, `Monterey`, `Ventura`, `Sonoma`, `Sequoia`, `Tahoe` and `Golden Gate`

Capability	Description	Expected values
`deviceName`	Mobile or tablet to test on	The device you want to test on. View the list of devices we support.
`osVersion`	Version of the OS to test on	Check the OS versions available for the specified device

Capability	Description	Expected values
`device`	Mobile or tablet to test on	The device you want to test on. View the list of devices we support.
`os_version`	Version of the OS to test on	Check the OS versions available for the specified device

By the way, did you know?

You can optimize your web apps for your mobile users by testing them on mobile devices. Run automated mobile browser tests using BrowserStack Automate.

Why test on mobile browsers?

Did this page help you?

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked

This page has exactly what I am looking for
This content & code samples are accurate and up-to-date
The content on this page is easy to understand
Other (please tell us more below)

Any additional feedback?

Thank you for your valuable feedback

Is this page helping you?

Yes

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked

This page has exactly what I am looking for
This content & code samples are accurate and up-to-date
The content on this page is easy to understand
Other (please tell us more below)

Any additional feedback?

Thank you for your valuable feedback!

Select browsers and devices

Example: Chrome for Testing capability (`browserstack.yml`)

Set platforms to test on

Sample script showing capability declarations for browser-OS combinations

BrowserStack-specific capabilities (Desktop)

Sample script showing capability declarations for desktop browsers

Sample script showing capability declarations for desktop browsers

Example: Chrome for Testing capability (Selenium 4 W3C)

BrowserStack-specific capabilities (Mobile)

Sample script showing capability declarations for mobile devices

Sample script showing capability declarations for mobile devices

Capability rules

We're sorry to hear that. Please share your feedback so we can do better

We're continuously improving our docs. We'd love to know what you liked

We're sorry to hear that. Please share your feedback so we can do better

We're continuously improving our docs. We'd love to know what you liked

Select browsers and devices

Example: Chrome for Testing capability (browserstack.yml)

Set platforms to test on

Sample script showing capability declarations for browser-OS combinations

BrowserStack-specific capabilities (Desktop)

Sample script showing capability declarations for desktop browsers

Sample script showing capability declarations for desktop browsers

Example: Chrome for Testing capability (Selenium 4 W3C)

BrowserStack-specific capabilities (Mobile)

Sample script showing capability declarations for mobile devices

Sample script showing capability declarations for mobile devices

Capability rules

We're sorry to hear that. Please share your feedback so we can do better

We're continuously improving our docs. We'd love to know what you liked

We're sorry to hear that. Please share your feedback so we can do better

We're continuously improving our docs. We'd love to know what you liked

Example: Chrome for Testing capability (`browserstack.yml`)