Run Selenium tests with Java | BrowserStack Docs

Selenium with Java

Your guide to running tests using Java on BrowserStack’s Selenium Grid of 3000+ real devices and desktop browsers.

This section covers running your first build with BrowserStack’s sample repo. To run builds with your existing test suite(s), skip to integrate your test suite.

Prerequisites

BrowserStack Username and Access key. You can find this in your account profile. If you do not have an account yet, please sign up for a Free Trial.

Maven

JDK 11+, Maven 3.6+, Selenium 4.23+ (W3C).
If you are using CLI for running tests, ensure that Maven is installed on your machine, its environment variables are set, and its bin is added to system path, $PATH.

Gradle

Java v9+
If you are using CLI for running tests, ensure that Gradle is installed on your machine, its environment variables are set, and its bin is added to system path, $PATH.

Run a sample build

Run a sample Java test build using your preferred method on BrowserStack:

Maven
Gradle

If you are using Maven, follow the given steps to run the sample build:

Configure your browserstack.yml config file

The browserstack.yml file holds all the required capabilities to run your tests on BrowserStack

Set access credentials

Set userName and accessKey properties in the browserstack.yml file, available in the root directory, to authenticate your tests on BrowserStack.

Select desktop browsers or real devices from a list of 3000+ available combinations:

Parallel thread

Windows 10

Chrome 120

Parallel thread

OS X Monterey

Safari 15.6

Parallel thread

iOS 15

iPhone 13

Did you know?

You can optimize your web apps for your mobile users by testing them on mobile devices. To get started, select a mobile device above.

Why test on mobile browsers?

Configure AI Agents

You can enable the following AI agents by adding the respective configurations in your browserstack.yml file:

Enable Self Heal Agent

Auto-fix locator failures with the AI-powered self-heal agent and get up to 40% fewer locator failures. Learn more

Test Failure Analysis Agent

Auto-enabled AI-powered root cause analysis for test failures that can reduce debugging time. Learn more

Update the browserstack.yml config file

Copy and replace the platforms object in the browserstack.yml file.

userName: YOUR_USERNAME
accessKey: YOUR_ACCESS_KEY
platforms:
- YOUR_FIRST_OS_TYPE: YOUR_FIRST_OS
  YOUR_FIRST_OS_VERSION_TYPE: YOUR_FIRST_OS_VERSION
  YOUR_FIRST_BROWSER_TYPE: YOUR_FIRST_BROWSER
  YOUR_FIRST_BROWSER_VERSION_TYPE: YOUR_FIRST_BROWSER_VERSION
- YOUR_SECOND_OS_TYPE: YOUR_SECOND_OS
  YOUR_SECOND_OS_VERSION_TYPE: YOUR_SECOND_OS_VERSION
  YOUR_SECOND_BROWSER_TYPE: YOUR_SECOND_BROWSER
  YOUR_SECOND_BROWSER_VERSION_TYPE: YOUR_SECOND_BROWSER_VERSION
- YOUR_THIRD_OS_TYPE: YOUR_THIRD_OS
  YOUR_THIRD_OS_VERSION_TYPE: YOUR_THIRD_OS_VERSION
  YOUR_THIRD_BROWSER_TYPE: YOUR_THIRD_BROWSER
  YOUR_THIRD_BROWSER_VERSION_TYPE: YOUR_THIRD_BROWSER_VERSION
browserstackLocal: true
buildName: browserstack-build-1
projectName: BrowserStack Sample
selfHeal: YOUR_SELF_HEAL

Run sample tests on BrowserStack

Run the tests using the following steps:

Install dependencies and run a sample test build on BrowserStack:

mvn test

If you are using Gradle, follow the given steps to run the sample build:

gradle build
gradle clean sampleTest

After you run your test, visit the Automate dashboard to view your test results.

Next steps

After you have successfully run your first test on BrowserStack, try integrating your test suite with BrowserStack.