Specify Browsers and OS

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

You can use the browsers option in browserstack.json to specify the list of OS, browser and browser versions. Each browser combination should contain the following details:

key value Possible values
os Operating system you want to run the tests on Windows 10, OS X Mojave and OS X Catalina
browser Browser you want to run the tests on chrome, firefox and edge
versions A list of supported browser versions you want to run the tests on Chrome: 66 to 86 (except 82)
Firefox: 60 to 81
Edge: 80 to 86 (except 82)

You can also use latest, 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.

For example, if you want to run latest 3 versions following browsers:

  • Chrome on Windows 10
  • Edge on Windows 10
  • Firefox on OS X Mojave
  • Edge on OS X Catalina
browserstack.json
{
  ...
  "browsers": [{
      "os": "Windows 10",
      "browser": "chrome",
      "versions": ["latest", "latest - 1", "latest - 2"]
    },
    {
      "os": "Windows 10",
      "browser": "edge",
      "versions": ["latest", "latest - 1", "latest - 2"]
    },
    {
      "os": "OS X Mojave",
      "browser": "firefox",
      "versions": ["latest", "latest - 1", "latest - 2"]
    },
    {
      "os": "OS X Catalina",
      "browser": "edge",
      "versions": ["latest", "latest - 1", "latest - 2"]
    }
  ]
  ...
}

You can always specify the exact versions to test on as well. For example, this configuration would run all your tests on 9 different combinations:

  • Chrome v69, v80, v81 on Windows 10
  • Edge v80, v81 on Windows 10
  • Firefox v69, v66 on OS X Mojave
  • Edge v80, v81 on OS X Catalina
browserstack.json
{
  ...
  "browsers": [{
      "os": "Windows 10",
      "browser": "chrome",
      "versions": ["69", "80", "81"]
    },
    {
      "os": "Windows 10",
      "browser": "edge",
      "versions": ["80", "81"]
    },
    {
      "os": "OS X Mojave",
      "browser": "firefox",
      "versions": ["69", "66"]
    },
    {
      "os": "OS X Catalina",
      "browser": "edge",
      "versions": ["80", "81"]
    }
  ]
  ...
}

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