How To Use @RepeatedTest Annotation In JUnit 5

How to use JUnit 5 @RepeatedTest annotation

JUnit Jupiter @RepeatedTest annotation is used to repeat the test case for specified no. of times. Each invocation of the test case behaves like a regular @Test method, so it has support for the same lifecycle callbacks and extensions in JUnit 5.

The following example declares myTest() to repeat execution five times:

@RepeatedTest(5)
void myTest() {
// ...
}

There are certain rules associated with the method @RepeatedTest in JUnit 5.

• The @RepeatedTest in JUnit 5 can not be private and static.
• The return type for @RepeatedTest in JUnit 5 must be void.

Let’s see how it is used in the test case with a basic example-

Test Case

• Launch the URL- https://www.amazon.com/
• Click on the navigation menu item- “BestSellers.”
• Validate that the page opened has the heading-“Amazon BestSellers.”
• Repeat the same test case 5 times.

package Test;

import java.net.MalformedURLException;
import java.net.URL;

import org.junit.After;
import org.junit.Before;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.RepeatedTest;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.junit.jupiter.api.Test;
import junit.framework.Assert;

public class RepeatedTestDemo {
   public WebDriver driver = null;

   @BeforeEach
   public void setup() throws Exception {
       System.setProperty("webdriver.chrome.driver",
               "DRIVER_EXE_PATH");
       driver = new ChromeDriver();
   }

   @RepeatedTest(value = 5)
   public void repeatedTestDemo() throws Exception {
       try {
          
           driver.get("https://www.amazon.in/");
           driver.findElement(By.xpath("//a[text()='Best Sellers']")).click();
           String actual = driver.findElement(By.xpath("//div[@id='zg_banner_text']/div[1]")).getText();
           Assert.assertEquals("Pass", "Amazon Bestsellers", actual);
       } catch (Exception e) {
           System.out.println(e.getMessage());
       }
   }

   @AfterEach
   public void tearDown() throws Exception {
       driver.quit(); // for illustration
   }

}

Following is the output of the above code:

As we can see, by default, JUnit displays the repetition number along with the total number of repetitions. We can also modify the display name, which we will discuss later. For now, let us do a code walk-through.

As it is quite evident that @RepeatedTest in JUnit 5 is treated as @Test annotation by JUnit 5, the lifecycle is also the same. For example, @BeforeEach and @AfterEach methods will be invoked before and after each invocation of the @RepeatedTest method in JUnit 5.

Also Read – JUnit Asserts With Examples

How to use RepeatedTest: RepetitionInfo Interface in JUnit 5

RepetitionInfo interface defines methods to retrieve the information about the current repetition and the total no. of repetitions. Here’s how we can use it.

• RepetitionInfo.getCurrentRepetition() returns current repetition.
• RepetitionInfo.getTotalRepetitions() returns total no. of repetitions.

How to use RepeatedTest : RepeatedTest Interface in JUnit 5

RepeatedTest interface defines methods to get attributes of the annotation @RepeatedTest of the test method. Here’s how we can use it-

• RepeatedTest.name() returns the name value passed as a parameter in @RepeatedTest Annotation.
• RepeatedTest.name() returns the name value passed as a parameter in @RepeatedTest Annotation.

However, the best way to harness the real potential of the JUnit framework for test automation is to shift it from a local Selenium Grid to a cloud-based Selenium Grid so that it can be executed in any browser anywhere in the world. When combined with TestMu AI, the JUnit framework allows developers to execute automated acceptance tests on a cloud Selenium Grid, which provides true remote testing capabilities.

TestMu AI is a cloud-based automated cross browser testing platform that allows you to easily run Selenium tests on more than 2,000 real browsers and operating systems in the cloud. You can run tests on any online browser or operating system with just one command, or create powerful suites that contain thousands of your own custom-built test steps.

Selenium-Jupiter allows you to run Selenium tests against a Grid of Remote Web Browsers (RWB) on different browser and platform combinations. TestMu AI helps you run parallel testing in Selenium with increased efficiency and speed, by making use of cloud-based automation.

Also Read – Parallel Testing With JUnit 5 And Selenium [Tutorial]

Conclusion

In this Selenium JUnit 5 tutorial, we have covered the annotation @RepeatedTest in JUnit 5 along with its use case. As we discussed, the annotation is particularly useful when we want to ascertain a scenario. In addition, the advantage of having an exclusive functionality for such a case is wonderful. So, what’s your use case for this annotation? Let us discuss this in the comments.

Happy Testing!