The following is a list of capabilities Selenium offers to specify the browser and the OS.
Capability
Description
Expected values
browserName
Browser you want to test
Firefox, Google Chrome, Microsoft Edge
Default: Google Chrome
browserVersion
Browser version you want to test
Supported versions on a particular grid.
You can also use latest, latest - 1, latest - 2, etc., to test on the latest n versions of the specified browser as you specify..
Default: Latest stable version supported by Grid for the browser selected.
Selenium capability rules
The following rules are defined to help you specify which browser, OS, and device combination to test on, resolving capability conflicts.
The value ANY, if given to any capability that supports that value, is same as the capability preference not specified.
The default browser is Chrome when no browser is declared by the user or the Selenium API (implicitly).
Supported browser versions for Selenium
The following are the supported browser versions for different browsers in Automation Grid. Use the browserVersion capability to run Selenium sessions on specific browser versions.
BrowserStack recommends using the latest three major versions of Selenium. Older versions are supported but not actively maintained.
Google Chrome
For Chrome, the following browser versions are supported to run Selenium sessions. Set the browser capability to chrome and browserVersion capability with one of the following values to run a test on a particular version of Chrome.
Chrome versions 138.0 through 147.0 are not available on Automation Grid.
Mozilla Firefox
For Firefox, the following browser versions are supported to run Selenium sessions. Set the browser capability to firefox and browserVersion capability with one of the following values to run a test on a particular version of Firefox.
For Edge, the following browser versions are supported to run Selenium sessions. Set the browser capability to MicrosoftEdge and browserVersion capability with one of the following values to run a test on a particular version of Edge.
Automate self-hosted allows you to run Playwright tests across multiple operating systems and browser versions. The following table lists the supported combinations and their corresponding Playwright versions for cross-browser Playwright tests. Reviewing these configurations helps you accurately define your browserstack.yml file and ensures your tests execute as expected.
The following os, browserName, and browserVersion parameters are supported for your Playwright tests on BrowserStack.
Parameters
Example values
Description
os
linux, windows
Operating system you want to run the tests on.
browserName
For branded browsers, use: chrome or edge. For Playwrightβs bundled browsers, use: playwright-chromium, playwright-firefox, or playwright-webkit.
Browser you want to run the tests on.
browserVersion
Chrome: 126, 129, 130, 131 Edge: 126, 128, 129, 130 You can also use latest, latest-1, latest-2, etc., to test on the latest n versions of the specified browser.
Applicable only if the browser is chrome or edge and detected client Playwright version is above or equal to 1.45.
The following example shows how the os, browser, and browser_version need to be defined in a key: value JSON structure in the caps variable:
The following os, browser, and browser_version parameters are supported for your Playwright tests on BrowserStack.
Parameter
Expected Values
Description
os
linux, windows
Operating system you want to run the tests on.
browser
For branded browsers, use: chrome or edge. For Playwrightβs bundled browsers, use: playwright-chromium, playwright-firefox, or playwright-webkit.
Browser you want to run the tests on.
browser_version
Chrome: 126, 129, 130, 131 Edge: 126, 128, 129, 130 You can also use latest, latest-1, latest-2, etc., to test on the latest n versions of the specified browser.
Applicable only if the browser is chrome or edge and detected client Playwright version is above or equal to 1.45.
Playwright compatible devices and browsers
The following table lists the supported platforms and corresponding Playwright versions and the compatible device and browser versions:
BrowserStack recommends using the latest three major versions of Playwright. Older versions are supported but not actively maintained.
If you have a use case where you need to use a Playwright version other than the ones we support, contact us.
Supported Cypress and browsers versions for Cypress tests
When running any Cypress test, you have to specify the browser and version that you want to use for the test. This document lists all of the supported browsers and Cypress versions for cross-browser Cypress tests. It also includes the values to specify in the capability to accomplish that.
Specify browser and OS
key
value
Possible values
os
Name of the operating system
linux
browser
Name of the browser
chrome, firefox, edge, webkit
versions
A list of supported browser versions
Use latest, latest-1, latest-2, and so on, to test on the latest n versions of the required browser.
The sample structure of the browsers object is as follows: