How does TestNG invoke a test method using multiple threads?

TestNG supports multi-threading, i.e., a @Test method can be invoked multiple times in parallel. A test method should be invoked from multiple threads so that multiple invocation is also required. If we want to run a single @Test at multi-thread, it is of no use. Therefore, multi-thread is useful if a @Test method needs to be run multiple times asynchronously.

Multi-threading can be achieved by using the keyword threadPoolSize = at @Test. However, to invoke a method multiple times, another keyword invocationCount =  is required. Combining these two keywords, we can achieve multi-threading. For example,

@Test(threadPoolSize=5, invocationCount = 10)

In this example, the @Test method will execute for a total of 10 times from 5 threads. Note that the count of total execution is 10 from 5 different threads. It doesn't mean that @Test will run a total of 50 times or 10 times in each thread. It simply means, 5 threads will execute the method a total of 10 times.

In this article, we will illustrate how to achieve multithreading in TestNG.

Approach/Algorithm to solve this problem −

  • Step 1 − Create a TestNG class called NewTestngClass.

  • Step 2 − Write a @Test method in the class, as shown in the program code section. Add threadPoolSize and invocationCount

  • Step 3 − Now create the testNG.xml 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.

In the output, you can notice that there are 5 threads are running in parallel (Thread ID 12 to 16) and the method runs for a total of 10 times.


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


import org.testng.ITestContext;
import org.testng.annotations.*;
public class NewTestngClass {
   @Test(threadPoolSize = 5, invocationCount = 10)
   public void testcase1(ITestContext testContext){
      System.out.println("Thread ID: "+Thread.currentThread().getId());
      int currentCount = testContext.getAllTestMethods()[0].getCurrentInvocationCount();
      System.out.println("Executing count: " + currentCount);


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


Thread ID: 12
Thread ID: 13
Thread ID: 16
Thread ID: 14
Executing count: 0
Thread ID: 15
Executing count: 0
Executing count: 0
Executing count: 0
Executing count: 0
Thread ID: 15
Executing count: 5
Thread ID: 12
Executing count: 6
Thread ID: 13
Executing count: 7
Thread ID: 14
Executing count: 8
Thread ID: 15
Executing count: 9

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