Specify a Playwright version

Learn how to set the supported Playwright version in your Playwright tests.

BrowserStack detects the browser and browser_version from the capability set in your test script and selects the appropriate Playwright version. If the browser_version is not specified, the Playwright version used will be the same as the Playwright client version. If you have a use case where you need to set the Playwright version explicitly, only then consider using the browserstack.playwrightversion capability in your test script.

In this guide, you will learn about:

• How BrowserStack sets Playwright version
• Setting the Playwright version

How BrowserStack sets Playwright version

BrowserStack uses the following order of precedence to decide which Playwright version to use:

Set the Playwright version

If you must set the Playwright version explicitly, set the browserstack.playwrightVersion key to the required version in your test script.

The following sample code snippet sets the Playwright version to 1.latest:

// fixtures.js

const caps = {
    'browser': 'playwright-webkit',
    'os': 'os x',
    'os_version': 'catalina',
    'browserstack.playwrightVersion': '1.latest'
  };

// sample.js

const caps = {
    'browser': 'playwright-webkit',
    'os': 'os x',
    'os_version': 'catalina',
    'browserstack.playwrightVersion': '1.latest'
  };

// sample.java

JsonObject capabilitiesObject = new JsonObject();
capabilitiesObject.addProperty("browser", "playwright-webkit");
capabilitiesObject.addProperty("browserstack.playwrightVersion", "1.latest");
capabilitiesObject.addProperty("os", "osx");
capabilitiesObject.addProperty("os_version", "catalina");

# sample.py

desired_cap = {
  'browser': 'playwright-webkit',
  'browserstack.playwrightVersion': '1.latest',
  'os': 'osx',
  'os_version': 'catalina',
}

// sample.cs
 {
 using var playwright = await Playwright.CreateAsync();
    Dictionary<string, string> browserstackOptions = new Dictionary<string, string>();   
    browserstackOptions.Add("os", "osx");
    browserstackOptions.Add("os_version", "catalina");
    browserstackOptions.Add("browser", "playwright-webkit");
    browserstackOptions.Add("browserstack.playwrightVersion", "1.latest")
 }   

Need some help?

If you have a use case where you need to use a Playwright version other than the ones we support, please reach out to our Support team.