How to use TestNG SkipException?

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 as 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 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 3 ways.

Approach/Algorithm to solve this problem −

  • Step 1 − Create a TestNG class called NewTestngClass.

  • Step 2 − Write three different @Test methods in the class, 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 two tests will be executed.

    • 2nd @Test Method − It throws SkipException. TestNG will print the 1st line of code and skip the rest as soon as it reaches the 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 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

Updated on: 09-Mar-2022

4K+ Views

Kickstart Your Career

Get certified by completing the course

Get Started