How to skip or ignore the execution of tests in TestNG?

TestNG supports multiple ways to skip or ignore a @Test execution. Based on requirement, the user can skip a complete test without executing it at all or skip a test based on a specific condition. If the condition meets at the time of execution, it skips the remaining code in the test.

Following are the ways to skip the @Test execution −

  • Use the parameter enabled=false at @Test. By default, this parameter is set to True.

  • Use throw new SkipException(String message) to skip a test.

  • Conditional Skip − The user can have a condition check. If the condition is met, it will throw a SkipException and skip the rest of the code.

In this article, we will illustrate how to skip a test in a class using the above three ways.

Approach/Algorithm to solve this problem −

  • Step 1 − Create a TestNG class called NewTestngClass.

  • Step 2 − Write three different @Test methods inside NewTestngClass as shown in the programming code section.

    • 1st @Test Method − It is enabled=false. It won't execute at all and TestNG ignores it completely at runtime. Even in consolidated run details, it is not considered, so only 2 tests will be executed.

    • 2nd @Test Method − It throws SkipException. TestNG will print the first line of code and skip after it reaches to SkipExecution code.

    • 3rd @Test Method − It is conditional skip. The code checks whether the DataAvailable parameter is True or False. If it is False, it throws a SkipException and skips the test. But, if DataAvailable is True, it won't throw the SkipException and continue the execution.

  • 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"/>


Testcase 2 - skip exception example
Test ignored.
Test Case3 - Conditional Skip
Test ignored.

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