Supported browser and OS versions for Playwright tests

Learn about the browsers and OS versions that you can run Playwright tests on and how to specify them.

Important: Playwright testing on BrowserStack (beta) is not available to all users yet. If you’d like to get access, please submit a request here.

Before triggering any Playwright test, you have to specify the OS and browser that you want to use for the test. This document would list all the supported browser and OS versions that you can use for your cross-browser Playwright tests and also what values to specify in the capability to achieve that.

The os, os_version, browser and browser_version need to be defined in a key: value JSON structure as shown in the example caps variable below:

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
os_version Operating system version where you want to run your test on Windows: 10
OS X: Mojave, Catalina and Big Sur
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.
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. Read more to learn how to run cross-browser Playwright tests in parallel.

Examples of how to specify the browser and version of your choice

  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
      };
    


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