TestNG - Ignore Test


Sometimes, it happens that our code is not ready and test case written to test that method/code will fail if run. In such cases, annotation @Test(enabled = false) helps to disable this test case.

A test method is annotated with @Test(enabled = false), then the test case that is not ready to test is bypassed.

Now, let's see @Test(enabled = false) in action.

Create a Class

  • Create a java class to be tested say MessageUtil.java in C:\ > TestNG_WORKSPACE

* This class prints the given message on console.
public class MessageUtil {

   private String message;

   //@param message to be printed
   public MessageUtil(String message){
      this.message = message; 

   // prints the message
   public String printMessage(){
      return message;

   // add "Hi!" to the message
   public String salutationMessage(){
      message = "Hi!" + message;
      return message;

Create Test Case Class

  • Create a java test class say IgnoreTest.java.

  • Add test methods testPrintMessage(), testSalutationMessage() to your test class.

  • Add an Annotation @Test(enabled = false) to method testPrintMessage().

Create a java class file name IgnoreTest.java in C:\ > TestNG_WORKSPACE

import org.testng.Assert;
import org.testng.annotations.Test;

public class IgnoreTest {
    String message = "Manisha";
    MessageUtil messageUtil = new MessageUtil(message);

    @Test(enabled = false)
    public void testPrintMessage() {
        System.out.println("Inside testPrintMessage()");
        message = "Manisha";
	Assert.assertEquals(message, messageUtil.printMessage());

    public void testSalutationMessage() {
        System.out.println("Inside testSalutationMessage()");
	message = "Hi!" + "Manisha";
	Assert.assertEquals(message, messageUtil.salutationMessage());

Create testng.xml

Create a testng.xml C:\ > TestNG_WORKSPACE to execute Test case(s).

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
<suite name="Suite1">
  <test name="test1">
       <class name="IgnoreTest" />

Compile the MessageUtil, Test case classes using javac.

C:\TestNG_WORKSPACE>javac MessageUtil.java IgnoreTest.java

Now, run the testng.xml, which will not run testPrintMessage() test case defined in provided Test Case class.

C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng.TestNG testng.xml

Verify the output. testPrintMessage() test case is not tested.

Inside testSalutationMessage()

Total tests run: 1, Failures: 0, Skips: 0

You can also Ignore a group of tests which will be discussed in the next chapter