From Wikipedia, the free encyclopedia
Jump to navigation Jump to search
Developer(s)Cédric Beust, the TestNG team
Stable release
7.3.0 / September 19, 2020; 3 months ago (2020-09-19)[1]
Repository Edit this at Wikidata
Written inJava
Operating systemCross-platform
TypeUnit testing tool
LicenseApache License 2.0[2]

TestNG is a testing framework for the Java programming language created by Cédric Beust and inspired by JUnit and NUnit. The design goal of TestNG is to cover a wider range of test categories: unit, functional, end-to-end, integration, etc., with more powerful and easy-to-use functionalities.


TestNG's main features include:

  1. Annotation support.
  2. Support for data-driven/parameterized testing (with @DataProvider and/or XML configuration).
  3. Support for multiple instances of the same test class (with @Factory)
  4. Flexible execution model. TestNG can be run either by Ant via build.xml (with or without a test suite defined), or by an IDE plugin with visual results. There isn't a TestSuite class, while test suites, groups and tests selected to run are defined and configured by XML files.
  5. Concurrent testing: run tests in arbitrarily big thread pools with various policies available (all methods in their own thread, one thread per test class, etc.), and test whether the code is multithread safe.
  6. Embeds BeanShell for further flexibility.
  7. Default JDK functions for runtime and logging (no dependencies).
  8. Dependent methods for application server testing.[clarification needed]
  9. Distributed testing: allows distribution of tests on slave machines.

Data provider[edit]

A data provider in TestNG is a method in a test class, which provides an array of varied actual values to dependent test methods.


	//This method will provide data to any test method that declares that its Data Provider is named "provider1". 
	@DataProvider(name = "provider1")
	public Object[][] createData1() {
		return new Object[][] { 
			{ "Cedric", new Integer(36) },
			{ "Anne", new Integer(37) }

	// This test method declares that its data should be supplied by the Data Provider named "provider1".
	@Test(dataProvider = "provider1")
	public void verifyData1(String n1, Integer n2) {
		System.out.println(n1 + " " + n2);

	// A data provider which returns an iterator of parameter arrays.
	@DataProvider(name = "provider2")
	public Iterator<Object[]> createData() {
		return new MyIterator(...);

	// A data provider with an argument of the type java.lang.reflect.Method.
	// It is particularly useful when several test methods use the same 
	// provider and you want it to return different values depending on 
	// which test method it is serving. 
	@DataProvider(name = "provider3")
	public Object[][] createData(Method m) {
		return new Object[][] { new Object[] { "Cedric" } };

The returned type of a data provider can be one of the following two types:

  • An array of array of objects (Object[][]) where the first dimension's size is the number of times the test method will be invoked and the second dimension size contains an array of objects that must be compatible with the parameter types of the test method.
  • An Iterator<Object[]>. The only difference with Object[][] is that an Iterator lets you create your test data lazily. TestNG will invoke the iterator and then the test method with the parameters returned by this iterator one by one. This is particularly useful if you have a lot of parameter sets to pass to the method and you don't want to create all of them upfront.

Tool support[edit]

TestNG is supported, out-of-the-box or via plug-ins, by each of the three major Java IDEs - Eclipse, IntelliJ IDEA, and NetBeans. It also comes with a custom task for Apache Ant and is supported by the Maven build system. The Hudson continuous integration server has built-in support for TestNG and is able to track and chart test results over time. Most Java code coverage tools, such as Cobertura, work seamlessly with TestNG.

Note: TestNG support for Eclipse is only embedded in the Eclipse Marketplace for Eclipse versions up to 2018-09 (4.9). For later versions of Eclipse, TestNG must be manually installed as per instructions in the TestNG site.[3]


TestNG generates test reports in HTML and XML formats. The XML output can be transformed by the Ant JUnitReport task[4] to generate reports similar to those obtained when using JUnit. Since version 4.6, TestNG also provides a reporter API[5] that permits third-party report generators, such as ReportNG,[6] PDFngreport[7] and TestNG-XSLT,[8] to be used.

Comparison with JUnit[edit]

The differences between and respective advantages of the two seemingly competing Java tools, TestNG and JUnit, have been debated throughout the decade. Both camps have strong grounds and supporters. Stackoverflow discussions reflect this controversy.[9][10][11]


In JUnit 4, the @BeforeClass and @AfterClass methods have to be declared as static. TestNG does not have this constraint.

TestNG has provided four additional setup/teardown pairs for the suite, test and groups, i.e. @BeforeSuite, @AfterSuite, @BeforeTest, @AfterTest, @BeforeGroup and @AfterGroup, @BeforeMethod and @AfterMethod. TestNG provide wide range of support to automate application using selenium.

Parameterized testing[edit]

Parameterized testing is implemented in both tools, but in quite different ways.

TestNG has two ways for providing varying parameter values to a test method: by setting the testng.xml, and by defining a @DataProvider method.

In JUnit 4, @RunWith and @Parameters are used together to facilitate parameterized tests, while the @Parameters method has to return List[] with all the actual values, which will be fed into a dedicated class constructor as an argument. In JUnit5 there is also the @ParameterizedTest annotation, which lets allows for the creation of a parameterized testing function.[12]



JUnit is often shipped with mainstream IDEs by default, which contributes to its wider popularity. However, TestNG's goal is much wider, which includes not only unit testing, but also support of integration and acceptance testing, etc. Which one is better or more suitable depends on use contexts and requirements.

See also[edit]


  1. ^ | Project GitHub releases page
  2. ^ "Apache License Version 2.0". January 2004. Archived from the original on 2013-12-21.
  3. ^ https://marketplace.eclipse.org/content/testng-eclipse
  4. ^ JUnitReport Archived 2010-02-24 at the Wayback Machine
  5. ^ Announcing TestNG 4.6
  6. ^ ReportNG 1.0 Final Released
  7. ^ PDFngreport 1.0.0
  8. ^ TestNG XSL Reports
  9. ^ "Junit vs TestNG". stackoverflow.com.
  10. ^ "JUnit vs TestNG". stackoverflow.com. Archived from the original on 2014-02-02.
  11. ^ "Which UnitTest framework to learn for Java now?". stackoverflow.com.
  12. ^ "JUnit 5 User Guide". junit.org.
  13. ^ "What is TestNG?". qacreators.com.

External links[edit]