How to disable an entire unit test in TestNG?

TestNG supports multiple ways to ignore all @Test execution. If required, a user can ignore a complete test without executing it at all. TestNG supports ignoring all @Test at the following levels −

  • In a class

  • In a particular package

  • In a package and all of its child package

The user has to use @Ignore annotation at the required level to disable the tests. The @Ignore annotation takes higher priority than individual @Test annotation.

To disable all the @Test in a class, just type @Ignore before the class name. It will disable all the @Test present inside the class.

In this article, we will illustrate how to disable an entire test in a class.

Approach/Algorithm to solve this problem −

  • Step 1 − Create a TestNG class called NewTestngClass.

  • Step 2 − Write two different @Test methods in the class and place the @Ignore annotation just above the class name as shown in programming code section.

  • Step 3 − Now create the testNG.xml as given below to run the TestNG classes.

  • Step 4 − Run the testNG.xml or run the testNG class directly in IDE or compile and run it using command line.


Use the following code for the common TestNG class "NewTestngClass" −


import org.testng.SkipException;
import org.testng.annotations.Test;
public class NewTestngClass {
   public void testcase1(){
      System.out.println("Testcase 1 - Not executed");
   public void testcase2(){
      System.out.println("Testcase 2 - skip exception example");
      throw new SkipException("Skipping this exception");
   public void testcase3(){
      boolean DataAvailable=false;
      System.out.println("Test Case3 - Conditional Skip");
         throw new SkipException("Skipping this exception");
      System.out.println("Executed Successfully");


This is a configuration file that is used to organize and run the TestNG test cases. It is very handy when limited tests are needed to execute rather than the full suite.

<?xml version = "1.0" encoding = "UTF-8"?>
<!DOCTYPE suite SYSTEM "">
<suite name = "Suite1">
   <test name = "test1">
         <class name = "NewTestngClass"/>


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

Updated on: 09-Mar-2022

2K+ Views

Kickstart Your Career

Get certified by completing the course

Get Started