Skip to main content
BrowserStack now allows you to run Playwright tests on android devices. To get started click here

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:

sample.js
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.
Note: Check out our guide on how to specify Playwright versions for your tests.

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:

  1. 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.
      };
    
  2. 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
      };
    
  3. 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'
      };
    
  4. If you want to run against the Edge v85 on Windows 10:
    const caps = {
     'browser': 'edge',
     'browser_version': '85',
     'os': 'Windows',
     'os_version': '10'
      };
    
  5. 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
      };
    
Note: Check out our list of Playwright compatible browsers you can use to run your tests.

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

Is this page helping 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.

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






Thank you for your valuable feedback!

Talk to an Expert
Talk to an Expert