Delivered by FeedBurner

Assert.assertEquals TestNG With Selenium WebDriver Example

There are many assertions available in Selenium WebDriver software testing tool with TestNG framework and we will look at all of then one by one. Assertions are important and very useful in any software automation tools to assert something during your test execution. If you know, Selenium IDE software testing tool has many built in assertion commands and if you are selenium IDE user then you can view set of selenium IDE assertion command examples on THIS LINK.

Difference between Assertion and verification
Verification and assertion is little different in software testing so don't be confused. Verification will just verify but assertion will first verify and if result is not as per expectation then it will stop execution of that specific test method. Today let we look at assertEquals assertion in selenium webdriver.

Assert.assertEquals(actual, expected) assertion
This assertion is useful to compare expected and actual values in selenium webdriver. If both values match then its fine and will continue execution. But if fails then immediately it will mark that specific test method as fail and exit from that test method.

You can use different types of values in actual and expected like boolean, byte[], char, double, float, int, etc.. but function is same for all. Let we look at simple example to understand it better.

Steps :
  • First of all, create 3 classes ( and as describe in THIS POST if you don't have created.
  • Now copy paste bellow given lines in your file.
Assertion and Verification Example Of Selenium WebDriver With TestNg

package TestNGOnePack;

import org.openqa.selenium.By;
import org.testng.Assert;
import org.testng.annotations.BeforeClass;
import org.testng.annotations.Test;

public class ClassTwo extends TestNGOnePack.BaseClassOne{
 String Actualtext;
 public void load_url(){
 //Method Example For Assertion
  public void assertion_method_1() {
  Actualtext = driver.findElement(By.xpath("//h2/span")).getText();
  Assert.assertEquals(Actualtext, "Tuesday, 28 January 2014");
  System.out.print("\n assertion_method_1() -> Part executed");
 //Method Example For Assertion
 public void assertion_method_2() {  
  Assert.assertEquals(Actualtext, "Tuesday, 29 January 2014");
  System.out.print("\n assertion_method_2() -> Part executed");
 //Method Example For Verification
 public void verification_method() {
  String time = driver.findElement(By.xpath("//div[@id='timeLeft']")).getText();
  if (time == "Tuesday, 28 January 2014")
   System.out.print("\nText Match");
   System.out.print("\nText does Match");

testng.xml example to run single class
To Run above example using testng.xml file, you will have to configure it as bellow.

<suite name="Suite One" configfailurepolicy="continue">
  <test name="Test One">
   <class name="TestNGOnePack.ClassTwo" />      

If you run above example, assertion_method_1() will display pass in result but assertion_method_2() will display fail because here expected and actual values will not match with each other.

If you will look in console, Only "assertion_method_1() -> Part executed" will be printed over there. "assertion_method_2() -> Part executed" will be not there because execution of current method was skipped after assertion failure. Last verification_method() is just simple verification method which verifies text and print message based on result.


  1. Thank you for creating this very useful resource.
    Quick question:
    Why in the code are used this comparing statement
    if (time == "Tuesday, 28 January 2014") ? May be better to compare two values to use following - if (time.equals("Tuesday, 28 January 2014")) ?

    Thank you

  2. While using if (time == "Tuesday, 28 January 2014") shows some error better use (time.equals("Tuesday, 28 January 2014"))

  3. is it OK to get exception as displaying in the image? or is there any work around to not get exceptions but method should mark as 'fail'? As i'm using this method "assertEqual(String actual,String expected, String message)", so it will through the error message string as given in the method.

  4. I executed the following code:
    Assert.assertEquals("ACCEPTED (0)", btnText1, "No task assigned to Accepted Category.");

    But the string "No task assigned to Accepted Category." is not getting printed. Please suggest the workarounds if any.