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.

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