How to do conditional skipping of tests in TestNG?

TestNG supports multiple ways to skip or ignore a @Test execution. Based on requirement, a 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 a @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 conditional check. If the condition is met, it will throw SkipException and skip the rest of the code.

In this article, we will illustrate how to do conditional skipping.

Approach for Conditional Skipping

  • Step 1 − Create a TestNG class called NewTestngClass.

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

    • 1st @Test Method − It is enabled=true. It will execute and TestNG will print the output.

    • 2nd @Test Method − It is conditional skip. The code checks whether DataAvailable parameter is True or False. If it is False, it throws 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 shown below to run the TestNG classes.

  • Step 4 − Now, 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("Test Case 1 - executed");
   public void testcase2(){
      boolean DataAvailable=false;
      System.out.println("Test Case 2 - 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"/>


Test Case 1 - executed
Test Case 2 - Conditional Skip

Test ignored.

Default Suite
Total tests run: 2, Passes: 1, Failures: 0, Skips: 1

Updated on: 09-Mar-2022

3K+ Views

Kickstart Your Career

Get certified by completing the course

Get Started