126

At work we are currently still using JUnit 3 to run our tests. We have been considering switching over to JUnit 4 for new tests being written but I have been keeping an eye on TestNG for a while now. What experiences have you all had with either JUnit 4 or TestNG, and which seems to work better for very large numbers of tests? Having flexibility in writing tests is also important to us since our functional tests cover a wide aspect and need to be written in a variety of ways to get results.

Old tests will not be re-written as they do their job just fine. What I would like to see in new tests though is flexibility in the way the test can be written, natural assertions, grouping, and easily distributed test executions.

blacktide
  • 10,654
  • 8
  • 33
  • 53
Sam Merrell
  • 2,352
  • 2
  • 16
  • 14

12 Answers12

67

I've used both, but I have to agree with Justin Standard that you shouldn't really consider rewriting your existing tests to any new format. Regardless of the decision, it is pretty trivial to run both. TestNG strives to be much more configurable than JUnit, but in the end they both work equally well.

TestNG has a neat feature where you can mark tests as a particular group, and then easily run all tests of a specific group, or exclude tests of a particular group. Thus you can mark tests that run slowly as in the "slow" group and then ignore them when you want quick results. A suggestion from their documentation is to mark some subset as "checkin" tests which should be run whenever you check new files in. I never saw such a feature in JUnit, but then again, if you don't have it, you don't REALLY miss it.

For all its claims of high configuration, I did run into a corner case the a couple weeks ago where I couldn't do what I wanted to do... I wish I could remember what it is, but I wanted to bring it up so you know that it's not perfect.

The biggest advantage TestNG has is annotations... which JUnit added in version 4 anyways.

Mike Stone
  • 44,224
  • 30
  • 113
  • 140
  • 14
    JUnit can do the grouping thing you are talking about by defining a test suite and then adding the tests in the desired group to that suite. You can then set up a target in your ant script that only runs that suite, and set up your source control to run that target upon checkin. – Justin Standard Sep 10 '08 at 22:46
  • 9
    The biggest advantage TestNG has over JUnit is the ability to dynanmically generate test data for parameterized tests. Each test data element is a different "test", so it makes it really easy to create data-driven tests http://testng.org/doc/documentation-main.html#parameters – davetron5000 Jan 23 '09 at 21:19
  • 6
    Parametrized tests are easy done with Theories, that are integrated in newer versions of Junit (but are experimental at the moment). – Mnementh Aug 05 '09 at 12:34
  • 9
    TestNG groups can be done in JUnit 4.8 with Categories: http://kentbeck.github.com/junit/doc/ReleaseNotes4.8.html. – Kaitsu Feb 01 '10 at 13:16
  • Some things not mentioned: I think TestNG's best advantage is being able to pass the same parameters that you passed into each test method, also into the before/after test configuration methods: this is great help in setup and teardown, IMHO very powerful. If you dont understand that, you might think you dont need it. Also, I like how you can define test suites in code. – djangofan Jun 16 '17 at 16:22
20

First I would say, don't rewrite all your tests just to suit the latest fad. Junit3 works perfectly well, and the introduction of annotations in 4 doesn't buy you very much (in my opinion). It is much more important that you guys write tests, and it sounds like you do.

Use whatever seems most natural and helps you get your work done.

I can't comment on TestNG b/c I haven't used it. But I would recommend unitils, a great wrapper for JUnit/TestNG/DBUnit/EasyMock, regardless of which route you take. (It supports all the flavors mentioned above)

Justin Standard
  • 21,347
  • 22
  • 80
  • 89
  • 1
    Unitils doesn't look like it has been updated in a while; will it work with newer versions of JUnit/TestNG? – Chinasaur Feb 08 '11 at 18:40
  • Just for anyone finding this answer in 2011, I checked, and the latest unitils version (3.2), has a release date of: 2011-09-29. So it *is* being actively maintained. – Ogre Psalm33 Oct 04 '11 at 13:58
18

TestNG's biggest draw cards for me include its support test groups, and more importantly - test group dependencies (marking a test as being dependent of a group causes the tests to simply skip running when the dependent group fails).

TestNG's other big draw cards for me include test parameters, data providers, annotation transformers, and more than anything - the vibrant and responsive user community.

Whilst on the surface one might not think all of TestNGs features above might not be needed, once you start to understand the flexibility bring to your tests, you'll wonder how you coped with JUnit.

(disclaimer - I've not used JUnit 4.x at all, so am unable to really comment on advances or new features there).

Mark Derricutt
  • 979
  • 1
  • 11
  • 20
  • 3
    I am using both JUnit4 and TestNG, TestNG has better support for spring spring-test integration. Makes testing spring based application a lot easier. – hidralisk Mar 23 '12 at 13:16
18

Cheers to all the above. Some other things I've personally found I like more in TestNG are:

  1. The @BeforeClass for TestNG takes place after class creation, so you aren't constrained by only being able to call static methods of your class in it.

  2. Parallel and parameterized tests, maybe I just don't have enough of a life... but I just get a kick writing one set of Selenium tests, accepting a driver name as a parameter. Then defining 3 parallel test groups, 1 each for the IE, FF and Chrome drivers, and watching the race! I originally did 4, but way too many of the pages I've worked on break the HtmlUnit driver for one reason or another.

Yeah, probably need to find that life. ;)

Piotr Nowicki
  • 17,914
  • 8
  • 63
  • 82
mezmo
  • 2,441
  • 19
  • 22
  • finally some meaty comment after all the ummm they are both equal ..and awwhing – user2412398 Aug 14 '15 at 11:23
  • Yeah, TestNG rules: I load driver instances via test args from the TestNG DataProvider as well. here is how I did it: https://github.com/djangofan/yet-another-selenium-framework/blob/master/src/main/java/qa/se/framework/ShootoutSuiteTestBase.java – djangofan Sep 01 '15 at 23:35
18

About a year ago, we had the same problem. I spent sometime considering which move was better, and eventually we realized that TestNG has no 'killer features'. It's nice, and has some features JUnit 4 doesn't have, but we don't need them.
We didn't want people to feel uncomfortable writing tests while getting to know TestNG because we wanted them to keep writing a lot of tests.
Also, JUnit is pretty much the de-facto standard in the Java world. There's no decent tool that doesn't support it from the box, you can find a lot of help on the web and they added a lot of new features in the past year which shows it's alive.

We decided to stick with JUnit and never looked back.

abyx
  • 69,862
  • 18
  • 95
  • 117
  • 1
    IMHO, TestNG's killer feature is the ability to pass context args in via Before and After setup methods. You can do a lot of neat magic tricks there that Junit cannot do. 95% of people don't bother to learn TestNG that well and are ignorant of it. Also, TestNG has a neat way of threading via DataProvider, but only if you take advantage of it. Also, testng.xml can contain Beanshell. – djangofan Jul 15 '19 at 19:07
11

I wanted to share the one I encountered today. I found built-in Parameterized runner is quite crude in Junit4 as compare to TestNG (I know each framework has its strengths but still). The Junit4 annotation @parameters is restricted to one set of parameters. I encountered this problem while testing the valid and invalid behavior for functionality in same test class. So the first public, static annotated method that it finds will be used, but it may find them in any order. This causes us to write different classes unnecessarily. However TestNG provides clean way to provide different kind of data providers for each and every method. So we can test the same unit of code with valid and invalid way in same test class putting the valid/invalid data separately. I will go with TestNG.

Adam
  • 5,215
  • 5
  • 51
  • 90
ravinikam
  • 3,666
  • 6
  • 28
  • 25
8

Also one more advantage of TestNG is supporting of parallel testing. In our era of multicores it's important, i think.

I also used both frameworks. But i using hamcrest for assertations. Hamcrest allows you easily write your own assert method. So instead of

assertEquals(operation.getStatus(), Operation.Status.Active);

You can write

assertThat(operation, isActive());

That gives you opportunity to use higher level of abstraction in your tests. And this makes your tests more robust.

Denis Bazhenov
  • 9,680
  • 8
  • 43
  • 65
7

JUnit 4 Vs TestNG – Comparison by mkyong.com ( updated on 2013).

Conclusion: I suggest to use TestNG as core unit test framework for Java project, because TestNG is more advance in parameterize testing, dependency testing and suite testing (Grouping concept).

TestNG is meant for functional, high-level testing and complex integration test. Its flexibility is especially useful with large test suites.

In addition, TestNG also cover the entire core JUnit4 functionality. It’s just no reason for me to use JUnit anymore.

In simple terms, TestNG = JUnit + lot more. So, Why debate ? go and grab TestNG :-)

You can find more detailed comparison here.

Sundararaj Govindasamy
  • 8,180
  • 5
  • 44
  • 77
6

Why we use TestNG instead of JUnit?

  1. The declaration of @BeforeClass and @AfterClass method has to be static in JUnit whereas, there is more flexibility in TestNG in the method declaration, it does not have these constraints.

  2. In TestNG, we can parametrize tests using 2 ways. @Parameter or @DataProvider annotation.

    i) @Parameter for simple cases, where key value mapping is required.(data is provided through xml file)

    ii) @DataProvider for complex cases. Using 2 dimensional array, It can provide data.

  3. In TestNG, since @DataProvider method need not be static, we can use multiple data provider methods in the same test class.

  4. Dependency Testing: In TestNG, if the initial test fails, then all subsequent dependent tests will be skipped, not marked as failed. But JUnit marked it failed.

  5. Grouping: Single tests can belong to multiple groups and then run in different contexts (like slow or fast tests). A similar feature exists in JUnit Categories but lacks the @BeforeGroups / @AfterGroups TestNG annotations that allow initializing the test / tearing it down.

  6. Parallelism: If you’d like to run the same test in parallel on multiple threads, TestNG has you covered with a simple to use annotation while JUnit doesn’t offer a simple way to do so out of the box.

  7. TestNG @DataProvider can also support XML for feeding in data, CSVs, or even plain text files.

  8. TestNG allows you to declare dependencies between tests, and skip them if the dependency test didn’t pass.

@Test(dependsOnMethods = { "dependOnSomething" })

This functionality doesn’t exist in JUnit

  1. Reporting:

TestNG reports are generated by default to a test-output folder that includes HTML reports with all of the test data, passed/failed/skipped, how long did they run, which input was used and the complete test logs. In addition, it also exports everything to an XML file which can be used to construct your own report template.

On the JUnit front, all of this data is also available via XML, but there’s no out of the box report and you need to rely on plugins.

Resource Link:

  1. A Quick JUnit vs TestNG Comparison
  2. JUnit vs. TestNG: Which Testing Framework Should You Choose?

A good difference is given in this tutorial side by side: TestNG Vs JUnit: What's the Difference?

SkyWalker
  • 28,384
  • 14
  • 74
  • 132
  • You didn't list TestNG's most distinct feature, IHMO: the ability to pass context args into Before and After methods, which enables you do do some magic. The DataProvider works this way, as an example. – djangofan Jul 15 '19 at 19:12
5

A couple of additions to Mike Stone's reply:

1) The most frequent thing I use TestNG's groups for is when I want to run a single test method in a test suite. I simply add this test to the group "phil" and then run this group. When I was using JUnit 3, I would comment out the entries for all methods but the one I wanted to run in the "suite" method, but then would commonly forget to uncomment them before checkin. With the groups, I no longer have this problem.

2) Depending on the complexity of the tests, migrating tests from JUnit3 to TestNG can be done somewhat automatically with sed and creating a base class to replace TestCase that static imports all of the TestNG assert methods.

I have info on my migration from JUnit to TestNG here and here.

  • the problem with checking in changes you did not intended is actualy because you have to review what you are checking in. And if you have a big check in , that is not an excuse, that is another problem: you should have many smaller checkins. – hidralisk Mar 23 '12 at 13:13
4

My opinion about what makes TestNG truly far more powerful:

1.  JUnit still requires the before/after class methods to be static, which limits
    what you can do prior to the running of tests, TestNG never has this issue.

2.  TestNG @Configuration methods can all take an optional argument to their 
    annotated methods in the form of a ITestResult, XmlTest, Method, or 
    ITestContext.  This allows you to pass things around that JUnit wouldn't 
    provide you.  JUnit only does this in listeners and it is limited in use.

3.  TestNG comes with some pre-made report generation classes that you can copy
     and edit and make into your own beautiful test output with very little 
     effort. Just copy the report class into your project and add a listener 
     to run it.  Also, ReportNG is available.

4.  TestNG has a handful of nice listeners that you can hook onto so you can do
     additional AOP style magic at certain phases during testing.
djangofan
  • 28,471
  • 61
  • 196
  • 289
3

Your question seems two folded to me. On one had you would like to compare two test frameworks, on the other hand you would like to implement tests easily, have natural assertions, etc...

Ok, firstly JUnit has been playing catchup with TestNG in terms of functionality, they have bridged the gap some what with v4, but not well enough in my opinion. Things like annotations and dataproviders are still much better in TestNG. Also they are more flexible in terms of test execution, since TestNG has test dependency, grouping and ordering.

JUnit still requires certain before/after methods to be static, which limits what you can do prior to the running of tests, TestNG never has this issue.

TBH, mostly the differences between the two frameworks don't mean much, unless your focusing on integration/automation testing. JUnit from my experience is built from the ground up for unit testing and is now being pushed towards higher levels of testing, which IMO makes it the wrong tool for the job. TestNG does well at unit testing and due to its robust dataproviding and great test execution abilities, works even better at integration/automation test level.

Now for what I believe is a separate issue, how to write well structured, readable and maintainable tests. Most of this I am sure you know, but things like Factory Pattern, Command Pattern and PageObjects (if your testing websites) are vital, it is very important to have a layer of abstraction between what your testing (SUT) and what the actual test is (assertions of business logic). In order to have much nicer assertions, you can use Hamcrest. Make use of javas inheritance/interfaces to reduce repetition and enforce commonality.

Almost forgot, also use the Test Data Builder Pattern, this coupled with TestNG's dataprovider annotation is very useful.

MostWanted
  • 571
  • 1
  • 5
  • 12