Supported browser and OS versions for Playwright tests
Learn how to specify browsers and OS versions for your Playwright tests.
When running any Playwright test, you have to specify the OS and browser that you want to use for the test. This document lists all of the supported browsers and OS versions for cross-browser Playwright tests, as well as the values to specify in the capability to accomplish that.
The following example shows how the os
, os_version
, browser
, and browser_version
need to be defined in a key
: value
JSON structure in the caps
variable:
const caps = {
'browser': 'chrome', // allowed browsers are `chrome`, `edge`, `playwright-chromium`, `playwright-firefox`, and `playwright-webkit`
'browser_version': 'latest',
'os': 'os x',
'os_version': 'big sur'
};
The following os
, os_version
, browser
, and browser_version
values are supported for your Playwright tests on BrowserStack.
Capability | Description | Possible values |
---|---|---|
os |
Operating system you want to run the tests on |
Windows and OS X Note: Check out the list of supported operating systems for running Playwright tests. |
os_version |
Operating system version where you want to run your test on |
Windows: 10 , 11 OS X: Mojave , Catalina , Big Sur , Monterey , and Ventura
|
browser |
Browser you want to run the tests on | For branded browsers, use: chrome or edge .The browser_version capability is applicable only when using a branded browser. For Playwright’s bundled browsers, use: playwright-chromium , playwright-firefox or playwright-webkit .We support 2 versions each of the above. Use browserstack.playwrightVersion capability as 1.latest or 1.latest-1 to choose the Playwright version. See the next section for an illustrated example. Note: Check out the list of supported browsers for running Playwright tests. |
browser_version |
Applicable only if the browser is chrome or edge
|
Chrome: 83 and above Edge: 83 and above You can also use latest , latest-beta , latest-1 , latest-2 , etc., to test on the latest n versions of the specified browser. |
You can see the usage of these capabilities in this sample script which runs a test across multiple cross-browser combinations in parallel. Check out how to run cross-browser Playwright tests in parallel.
Examples of how to specify the browser and version of your choice
The following Node.js
code examples show how to use the os
, os_version
, browser
, and browser_version
capabilities in different scenarios:
- If you want to run against the latest supported Webkit version on OS X Catalina:
const caps = { 'browser': 'playwright-webkit', 'os': 'os x', 'os_version': 'catalina', 'browserstack.playwrightVersion': '1.latest' // Use '1.latest-1' if you want to test against the previous playwright version which means previous webkit version as well. };
- If you want to run against the latest-1 supported Firefox version on Windows 10:
const caps = { 'browser': 'playwright-firefox', 'os': 'Windows', 'os_version': '10', 'browserstack.playwrightVersion': '1.latest-1' // latest-1 playwright version means the associated bundled firefox version will be used };
- If you want to run against the latest stable branded Google Chrome version on macOS Big Sur:
const caps = { 'browser': 'chrome', 'browser_version': 'latest', // Note we need to use 'browser_version' if using a branded browser like 'chrome' or 'edge' 'os': 'OS X', 'os_version': 'Big Sur' };
- If you want to run against the Edge v85 on Windows 10:
const caps = { 'browser': 'edge', 'browser_version': '85', 'os': 'Windows', 'os_version': '10' };
- If you want to run against the latest bundled Chromium (i.e. the dev channel chromium that comes bundled with the latest playwright version):
const caps = { 'browser': 'playwright-chromium', 'os': 'Windows', 'os_version': '10' // If 'browserstack.playwrightVersion' is not specified, by default we run on the latest available version on BrowserStack };
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
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
Thank you for your valuable feedback!