@Test annotation attributes - invocationCount attribute

Sometimes we encounter questions like how to run a single test case multiple times? Well, invocationCount is the answer to that question. In this post, we will discuss the invocationCount attribute used with @Test annotation in TestNG.

What does this attribute do, or what is the use of invocation count? invocationCount helps in executing a single test case multiple times. So, if you have a test case that needs to be run multiple times, invocationCount can help you.

Syntax

@Test(invocationCount = num) where num = the number of times you want to run this test method.

Example

package Test;
 
import org.testng.Assert;
import org.testng.annotations.Test;
 
public class CodekruTest {
 
    @Test(invocationCount = 5) // now, this test case will run 5 times
    public void test2() {
 
        System.out.println("test2 is passed");
        Assert.assertTrue(true);
    }
 
}

Below is the XML file to run the above test class

<suite name="codekru">
    <test name="codekruTest">
        <classes>
            <class name="Test.CodekruTest">
            </class>
        </classes>
    </test>
</suite>

Output after running the above XML file-

test2 is passed
test2 is passed
test2 is passed
test2 is passed
test2 is passed
PASSED: test2
PASSED: test2
PASSED: test2
PASSED: test2
PASSED: test2

===============================================
    Default test
    Tests run: 5, Failures: 0, Skips: 0
===============================================

So, here we can see that test() ran five times.

The What If scenarios

What if we kept invocationCount =0? What will happen then?

Here the test case won’t even run, as shown in the below example

package Test;
 
import org.testng.Assert;
import org.testng.annotations.Test;
 
public class CodekruTest {
 
    @Test(invocationCount = 0) // now, this test case will run 5 times
    public void test2() {
 
        System.out.println("test2 is passed");
        Assert.assertTrue(true);
    }
 
}

Output after running the same XML file –

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

Here we can see that no test case or method was executed.

What if we kept invocationCount as a negative value?

It won’t give any error, but the test case won’t be executed.

package Test;
 
import org.testng.Assert;
import org.testng.annotations.Test;
 
public class CodekruTest {
 
    @Test(invocationCount = -2) // now, this test case will run 5 times
    public void test2() {
 
        System.out.println("test2 is passed");
        Assert.assertTrue(true);
    }
 
}

Output –

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

We hope you liked the article. If you have any doubts or concerns, please feel free to write us in the comments or mail us at admin@codekru.com.

Other @Test attributes

Liked the article? Share this on

@Test annotation attributes – invocationCount attribute