Applies to CrossBrowserTesting SaaS, last modified on January 10, 2023

For this document, we provide an example test located in our JUnit GitHub Repository.

JUnit is a Java unit testing framework that is useful for creating scalable and repeatable tests. Eclipse is a widely used Java integrated development environment (IDE) containing a comprehensive workspace for user's code development needs.

In this guide we will use JUnit with Eclipse for testing using the Selenium WebDriver and Java programming language.

Set up Eclipse

  1. Download and install Eclipse IDE for Java Developers.

    Download Eclipse

    Click the image to enlarge it.

  2. After installing is complete, launch Eclipse.

    Eclipse welcome screen

    Click the image to enlarge it.

  3. Select Create a new Java project.

    New project in Eclipse

    Click the image to enlarge it.

Run a test

Note: You will need to use your Username and Authkey to run your tests on CrossBrowserTesting To get yours, sign up for a free trial or purchase a plan.
  1. Download Selenium WebDriver for Java.

    Download Selenium for Java

    Click the image to enlarge it.

  2. Add the Selenium jars to the build path of your project.

    • Right click your project folder and select Properties.

      Eclipse folder menu

      Click the image to enlarge it.

    • From the Java Build Path tab, select the Libraries tab.

      Eclipse build path

      Click the image to enlarge it.

    • Select Add External JARs and add all jars for Selenium.

      Eclipse add JARs

      Click the image to enlarge it.

      Eclipse selected JARs

      Click the image to enlarge it.

    • Apply and Close.

  3. Create a new JUnit Test Case

    • Right click your project folder.

    • Hover over New and select JUnit Test Case.

      Eclipse JUnit testcase

      Click the image to enlarge it.

    • Name your test case and select Finish.

      Eclipse new JUnit

      Click the image to enlarge it.

    • Select OK to add JUnit to the build path.

      Eclipse add JUnit

      Click the image to enlarge it.

  4. Copying the following content:


    import static org.junit.jupiter.api.Assertions.*;
    import org.junit.jupiter.api.AfterEach;
    import org.junit.jupiter.api.BeforeEach;
    import org.junit.jupiter.api.Test;
    import org.openqa.selenium.*;
    import org.openqa.selenium.remote.*;
    import java.net.URL;
    import java.util.concurrent.TimeUnit;
    import java.util.HashMap;

    class BasicExample {

          private WebDriver driver;

            void setUp() throws Exception {
                String username = "YOUR_USERNAME";
                String authkey = "YOUR_AUTHKEY";
                DesiredCapabilities capabilities = new DesiredCapabilities();
                    HashMap<String, String> cbtoptions = new HashMap<String, String>();
                    cbtoptions.put("record_video", record_video);
                    cbtoptions.put("screenResolution", 1366x768);
                    capabilities.setCapability("browserName", "Chrome");
                capabilities.setCapability("platformName", "Windows 10");
                capabilities.setCapability("name", "Junit Example");
                capabilities.setCapability("browserVersion", "84");
                capabilities.setCapability("cbt:options", cbtoptions);

                String hubAddress = String.format("http://%s:%s@hub.crossbrowsertesting.com:80/wd/hub", username, authkey);
                URL url = new URL(hubAddress);

                driver = new RemoteWebDriver(url, capabilities);
                driver.manage().timeouts().implicitlyWait(30, TimeUnit.SECONDS);

            void tearDown() throws Exception {

            void test() {
                assertEquals("Selenium Test Example Page", driver.getTitle());


  5. Run your test by selecting the Run button.

    Eclipse run

    Click the image to enlarge it.

Congratulations! You have successfully integrated CrossBrowserTesting and JUnit using Eclipse. Now you are ready to see your build start to run in the CrossBrowserTesting app.


By following the steps outlined in this guide, you are now able to seamlessly integrate JUnit and CrossBrowserTesting. If you have any questions or concerns, please feel free to reach out to our Support team.

See Also

Test Frameworks and Tools

Highlight search results