Skip to main content
Transform your testing process with: Real Device Features, Company-wide Licences, & Test Observability

Supported browser and OS versions for Puppeteer tests

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

When running any Puppeteer 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 Puppeteer 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',
  'browser_version': 'latest',
  'os': 'os x',
  'os_version': 'big sur'
};

The following os, os_version, browser, and browser_version values are supported for your Puppeteer 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: 11, 10,8.1, 8, and 7
OS X: Sonoma, Ventura, Monterey, Big Sur, Catalina, Mojave, OS X High Sierra, OS X Sierra, and OS X El Capitan
Note: Check out the list of supported operating systems for running Puppeteer tests.
browser Browser you want to run the tests on chrome, firefox, and edge
Note: Check out the list of supported browsers for running Puppeteer tests.
browser_version A list of supported browser versions you want to run the tests on Chrome: 72 and above
Firefox: 86 and above
Edge: 80 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.
Warning: Your tests won’t run if you pass the 82 as the version while testing on Chrome and Edge as both Google Chrome and Microsoft Edge teams cancelled the v82 releases.

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 Puppeteer tests in parallel.

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
Download Copy