BrowserStack Docs

A fresh look for capability generator

We are excited to unveil a fresh look for capabilities, along with SDK configuration and improved navigation. Hope you love it as much as we do.

Capabilities

Capabilities are a series of key-value pairs that allow you to configure your tests on the BrowserStack cloud grid.

Use our Capabilities Generator to configure your test suite in the language of your choice. The capabilities generator lets you select from a comprehensive set of options you can use to customize your tests on the BrowserStack Cloud grid. You can also find out more about each capability by scrolling to our Capabilities Reference section.

Capability generator

Other frameworks

Selenium - BrowserStack SDK

Tabs

Selenium

Integration method

Browserstack SDK
Non-SDK Integration
Non-YAML Schema

BrowserStack SDK

BrowserStack SDK is a plug-and-play solution that enables you to run your entire test suite with no code changes. Using the SDK reduces the integration time from hours to a few minutes.

Core Capabilities

Select browser or device combination

You can run multiple threads in parallel:

Parallel Thread #1: Windows 10 Chrome 120
Parallel Thread #2: OS X Monterey Safari 15.6
Parallel Thread #3: iOS iPhone 13

Parallels per platform

The number of parallel threads to be used for each platform set.

Resolution:
Selenium Version:
Appium Version:

Browser Specific Capabilities

Enable Popups: True / False (default)
Allow Cookies: True / False (default)

Project details

Project Name: Specify a name for a logical group of builds
Build Name: Specify a name for a logical group of tests
Build Identifier: Select a dynamic build identifier that appends to the build name and generates a unique name on the BrowserStack dashboard
Local Connectivity: Enable BrowserStack Local (Test localhost / internal servers in your network): True / False (default)
Debugging: Debug (Generate screenshots at various steps in your test): True / False (default)
Network Logs: Capture network logs for your test: True / False (default)
Record Videos: Enable video recording during your test: True (Default) / False
Console Logs: Capture network logs for your test
Selenium Logs: Enable seleniumLogs for your test: True (Default) / False
Interactive Debugging: Enable interactive debugging during your test: True (Default) / False
Appium Logs: Enable appium logs for your test: True (Default) / False

Timezone

Configure tests to run on a custom timezone

Note: View the complete list of timezones on Wikipedia

Simulate Network

Simulate different network conditions when testing on real mobile devices.

Device Orientation

userName: YOUR_USERNAME
accessKey: YOUR_ACCESS_KEY
platforms:
  - browserName: Chrome
    os: Windows
    osVersion: 10
    browserVersion: 120.0
  - browserName: Safari
    os: OS X
    osVersion: Monterey
    browserVersion: 15.6
  - browserName: chromium
    osVersion: 15
    deviceName: iPhone 13
buildIdentifier: ${BUILD_NUMBER}
consoleLogs: info

Capabilities reference gist file

# =============================================================================================================================
# Set BrowserStack Credentials
# =============================================================================================================================
userName: YOUR_USERNAME
accessKey: YOUR_ACCESS_KEY

# Set `framework` of your test suite. Example, `testng`, `cucumber`, `cucumber-testng`
framework: testng # Required only for java based frameworks

# =============================================================================================================================
# Parallels per Platform
# =============================================================================================================================
# The number of parallel threads to be used for each platform set.
# BrowserStack's SDK runner will select the best strategy based on the configured value
parallelsPerPlatform: 1

# =============================================================================================================================
# Platforms (Browsers / Devices to test)
# =============================================================================================================================
platforms:
  - os: OS X
    osVersion: Big Sur
    browserName: Chrome
    browserVersion: latest
  - os: Windows
    osVersion: 11
    browserName: Edge
    browserVersion: latest
  - os: Windows
    osVersion: 10
    browserName: Firefox
    browserVersion: latest
  - os: OS X
    osVersion: Big Sur
    browserName: Safari
    browserVersion: 14.1

# =============================================================================================================================
# BrowserStack Reporting
# =============================================================================================================================
projectName: BrowserStack Samples
buildName: browserstack build
buildIdentifier: '${BUILD_NUMBER}'

# =============================================================================================================================
# BrowserStack Local (For localhost, staging/private websites)
# =============================================================================================================================
browserstackLocal: true
browserStackLocalOptions:
  forcelocal: true
  localIdentifier: randomstring
  proxyHost: 127.0.0.1
  proxyPort: 8000

# =============================================================================================================================
# Debugging features
# =============================================================================================================================
debug: false
networkLogs: false
consoleLogs: errors

# =============================================================================================================================
# TEST CONFIGURATION CAPABILITIES
# =============================================================================================================================
video: true
seleniumLogs: true
telemetryLogs: true
geoLocation: CN
timezone: New_York
resolution: 1024x768
idleTimeout: 30
maskCommands: setValues, getValues, setCookies, getCookies
maskBasicAuth: true
autoWait: 35
hosts: 1.2.3.4 staging.website.com
bfcache: 1
wsLocalSupport: true
disableCorsRestrictions: true
httpProxy: http://user:pwd@127.0.0.1:1234
httpsProxy: https://user:pwd@127.0.0.1:1234

Test Reporting & Analytics

Test Reporting & Analytics is an intelligent test reporting & debugging product. It collects data using the SDK. Visit automation.browserstack.com to see your test reports and insights. To disable Test Reporting & Analytics, specify testObservability: false in the key below.

Did this page help you?

Yes / No

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.