Applies to CrossBrowserTesting SaaS, last modified on January 19, 2022

Get started with TestNG and CrossBrowserTesting

TestNG is a Java testing framework inspired by JUnit. TestNG introduces new functionalities that make it more powerful and easier to cover all categories of testing, including unit, functional, and end-to-end.

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

Capabilities should be given before your TestSuite has begin. Note that your username will have to contain %40 rather than the '@' character to avoid the MalformedURLException. The browser_api_name and os_api_name can be pulled from an API call to get possible combinations.

    public void setup() throws MalformedURLException {
        String username = "you%40yourdomain.com";
        String authkey = "yourauthkey";
        DesiredCapabilities caps = new DesiredCapabilities();
        caps.setCapability("browserName", "Chrome"); // Automatically pulls the latest version of Chrome
        caps.setCapability("platform", "Windows 10"); // To specify a version, add setCapability("version", "desired version")

        driver = new RemoteWebDriver(new URL("http://" + username + ":" + authkey +"@hub.crossbrowsertesting.com:80/wd/hub"), caps);

Create test cases

Actual test cases are prefixed by an @Test annotation as shown below. At this point, you can add any tests you would like, and they will be run against the driver instantiated in the setup method. Note that we can use TestNG's static Assert methods to assert attributes of our webpage.

    public void todoTest() {
        System.out.println("Loading Url");

                // maximize the window - DESKTOPS ONLY
                //System.out.println("Maximizing window");

                System.out.println("Checking Box");

                System.out.println("Checking Another Box");

                // If both clicks worked, then the following List should be have length 2
                List<WebElement> elems = driver.findElements(By.className("done-true"));
                // So we'll assert that this is correct.
                Assert.assertEquals(2, elems.size());

                System.out.println("Entering Text");
                driver.findElement(By.id("todotext")).sendKeys("Run your first Selenium Test");

                // Let's also assert that the todo we added is present in the list.
                String spanText = driver.findElementByXPath("/html/body/div/div/div/ul/li[6]/span").getText();
                Assert.assertEquals("Run your first Selenium Test", spanText);

                System.out.println("Archiving old todos");

                // If our archive link worked, then the following list should have length 4.
                elems = driver.findElements(By.className("done-false"));
                // So will assert that this is true as well.
                Assert.assertEquals(4, elems.size());



Tear downs can be annotated with @AfterSuite. While it goes without saying, you should always call driver.quit() in the teardown methods of your suite. Additionally, you can use our API to generate a test score in our App based on whether or not your test ran successfully.

    public void tearDown() {

Parallel testing

Parallel testing is fast and simple with TestNG. I do so by making modifications to my testng.xml configuration file. This can be done two ways, by suite:

<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
<suite name="CBT - Suite">
  <test name="Login">
      <class name="CBTTestNG.TestNG.TestNGBasic" />
      <class name="CBTTestNG.TestNG.TestNGLogin" />
      <class name="CBTTestNG.TestNG.TestNGTodo" />

As well as by capabilties. Note that the @parameter prefix will have to be added to your setup methods:

<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite thread-count="2" name="Suite" parallel="tests">
  <test name="FirstTest">
  <parameter name="os" value="Win10"/>
  <parameter name="browser" value="Chrome76"/>
      <class name="CBTTestNG.TestNG.TestNGTodo"/>
  <test name="SecondTest">
  <parameter name="os" value="Mac10.14"/>
  <parameter name="browser" value="Chrome76"/>
      <class name="CBTTestNG.TestNG.TestNGTodo"/>

Parameters reflected in test cases:

  @org.testng.annotations.Parameters(value={"os", "browser"})
  public void setUp(String os,String browser) throws Exception {
    DesiredCapabilities capability = new DesiredCapabilities();
    capability.setCapability("os_api_name", os);
    capability.setCapability("browser_api_name", browser);
    capability.setCapability("name", "TestNG-Parallel");
    driver = new RemoteWebDriver(
      new URL("http://" + username + ":" + authkey + "@hub.crossbrowsertesting.com:80/wd/hub"),

Additionally, test classes can be added and executed in parallel using an EntryPoint class, as shown below. This is especially useful for exporting your tests as a JAR so that it can be ran quickly from a continuous integration environment like Jenkins. Adding classes is simple:

import org.testng.TestListenerAdapter;
import org.testng.TestNG;

public class EntryPoint {
    public static void main(String[] args) {
        TestListenerAdapter tla = new TestListenerAdapter();
        TestNG testng = new TestNG();
        testng.setTestClasses(new Class[] { TestNGBasic.class, TestNGLogin.class, TestNGTodo.class , TestNGDD.class});


Data driven development with TestNG

Data driven development is becoming more and more popular and necessary, especially. TestNG and Java together give us an easy to work-with platform for importing data from Excel spreadsheets or a database. The example shown below does just that, and the same data can be used in CrossBrowserTesting to perform data-driven development quickly and efficiently:

public Sheet getSpreadSheet() {
        File file = new File("//Path//To//Test.xlsx");

        FileInputStream inputStream = null;
        Workbook wb = null;
        try {
            inputStream = new FileInputStream(file);
            wb = WorkbookFactory.create(inputStream);
        } catch (IOException ex) {
            System.out.println("Error Message " + ex.getMessage());
        } catch (InvalidFormatException e) {
            System.out.println("Invalid File format!");

        Sheet mySheet = wb.getSheet("MySheet");

        return mySheet;
    public void loginPage() {

        Sheet mySheet = getSpreadSheet();

        String user = mySheet.getRow(0).getCell(0).toString();
        String pass = mySheet.getRow(0).getCell(1).toString();

        // the first time around, it should not work!

        // then by entering the password
        System.out.println("Entering password");

        // then by clicking the login button
        System.out.println("Logging in");
        driver.findElementByCssSelector("div.form-actions > button").click();

        WebDriverWait wait = new WebDriverWait(driver, 10);
        wait.until(ExpectedConditions.textToBePresentInElement(By.xpath("/html/body/div/div/div/div[1]"), "Username or password is incorrect"));

        // however, with the correct credentials, it should!

        user = mySheet.getRow(1).getCell(0).toString();
        pass = mySheet.getRow(1).getCell(1).toString();


        // then by entering the password
        System.out.println("Entering password");

        // then by clicking the login button
        System.out.println("Logging in");
        driver.findElementByCssSelector("div.form-actions > button").click();

        // let's wait here to ensure the page has loaded completely
        wait = new WebDriverWait(driver, 10);

        String welcomeMessage = driver.findElementByXPath("//*[@id=\"logged-in-message\"]/h2").getText();
        Assert.assertEquals("Welcome tester@crossbrowsertesting.com", welcomeMessage);


We hit some major points here, but there is a ton of documentation out there. I would definitely recommend checking out TestNG's documentation as well as CrossBrowserTesting's own documentation for working with our API.

For examples and source code to this tutorial, check out our  TestNG GitHub Repository.

If you have any trouble, feel free to get in touch. We are always happy to help!

See Also

Test Frameworks and Tools
About Selenium Testing
Selenium and Java
Cucumber Java
Serenity Java

Highlight search results