How to Use JUnit Annotations In Selenium

JUnit is a Java-based, open-source framework to help you execute unit testing. JUnit is used primarily to test each and every unit or component of your application like classes and methods. It helps to write and run repeatable automated tests, to ensure your code runs as intended. The framework offers support to for web-apps or websites. Selenium test automation This article is my attempt to help you use JUnit annotations in Selenium as a professional tester would. We would be looking at examples of JUnit annotations in Selenium, their order of execution, along with some special JUnit annotations that are used for a specific purpose. We will also be looking into a collective code for executing each example of JUnit annotation in Selenium. At last, we will perform cross browser testing with Selenium Grid using JUnit annotations. Before we head on to JUnit annotations in Selenium, let us quickly recap the reasons behind JUnit’s popularity among the tester community. Why JUnit Is So Popular Among Testers? JUnit without a doubt, is considered as one of the . Below are the pointers behind it. top Java test frameworks Open Source Framework Offers integrations with IDEs such as Eclipse, IntelliJ etc. so you could test run your code quickly and easily. Offers integration with CI/CD tools such as Jenkins, Teamcity etc. to help you create a sturdy delivery pipeline. Offers assertions to help you conveniently compare actual results with the expected results. Offers annotations to help you identify the type of test methods. Provides a facility to create a test suite which further includes multiple test cases and even other test suites. Provides Test Runner to help your easily execute a Test Suite. Makes the test code more readable, elegant and increases the quality. Provides JUnit Test Report Generation in HTML format. What Are JUnit Annotations? As stated in the pros above, JUnit Annotations in Selenium help to identify the type of methods we have defined in our test code. But the question that arises here is, how do we use JUnit annotations in Selenium? What are the keywords that defines JUnit annotations in Selenium? When to use JUnit annotations in Selenium? If you are going through the same questions then I will help you get to the answer of them by the end of this article. So, basically Annotations are the meta-tags that provides additional information about the methods and classes defined in our code structure. In order to execute , it is necessary to add JUnit Annotations in our script. Selenium WebDriver testing with JUnit Note: JUnit Annotations would only be accessible in JUnit 4 plus versions and it requires at least JDK(Java Development Kit) 1.5 version. Below is the list of every JUnit annotation in Selenium that will be covered in this blog. Common JUnit Annotations In Selenium @BeforeClass @Before @Test @After @AfterClass @Ignore JUnit annotations In Selenium For Specific Purposes @ParameterizedTest @RunWith @RepeatedTest @Parameters Digging Deeper with Examples of JUnit Annotations In Selenium WebDriver Now, we look at each annotation one by one and at the end, I’ll present you the entire compiled code representing all the annotations along with the console output, at the end of this section. @BeforeClass { System.out.println( ); } @BeforeClass public static void SetUpClass () //Initialization code goes here "This is @BeforeClass annotation" @Before This annotation is used whenever we want to initialize any object for the time the method is being used. Suppose, we are having 5 test cases, the Before method will be called before each test method for 5 times. So, it would be invoked every time the test case is executed. This annotation is usually used for setting up the test environment. { System.out.println( ); } @Before public void SetUp () // Setting up the test environment "This is @Before annotation" @Test This annotation tells JUnit that the public void method() to which it is attached can be run as a test case. This annotation includes the test method for an application that you want to test. A single automation test script may comprise numerous test methods in it. { c= a+b; assertEquals( ,c); System.out.println( +c); } { c=a*b; assertEquals( ,c); System.out.println( +c); } @Test public void Addition () 15 "This is first @Test annotation method= " @Test public void Multiplication () 50 "This is second @Test annotation method= " @After Whatever we have initialized in @Before annotation method, that initialization should be released in @After annotation method. So, this annotation is executed every time after each test method. The primary purpose of @After annotation is to teardown. Teardown is a process of deleting temporary data. Teardown can also be used to define the default values or to wipe the slate clean of the test environment. { c= ; System.out.println( ); } @After public void TearDown () // Cleaning up the test environment null "This is @After annotation" @AfterClass Whatever we have initialized in @BeforeClass annotation method, that initialization should be released in @AfterClass annotation method. So, this annotation is executed once but it will be executed after all tests has finished executing. { System.out.println( ); } @AfterClass public static void TearDownClass () //Release your resources here "This is @AfterClass annotation" @Ignore This annotation tells JUnit that this method shall not be executed. In scenarios, where our code module is not ready in a particular test case, we can temporarily put that code module in @Ignore annotation method to avoid test case failure. Native JUnit 4 offers powerful reporting to help you realize the count of tests that were ignored along with count of tests that run and count of tests that failed. { String info = ; assertEquals(info, ); System.out.println( ); } @Ignore public void IgnoreMessage () "JUnit Annotation Blog" "JUnit Annotation Blog" "This is @Ignore annotation" Here is the compiled code with output representing all the JUnits annotations in Selenium WebDriver: JUnitAnnotationBlog; org.junit.Assert.assertEquals; org.junit.After; org.junit.AfterClass; org.junit.Before; org.junit.BeforeClass; org.junit.Ignore; org.junit.Test; { a= ; b= ; Object c; { System.out.println( ); } { System.out.println( ); } { c= a+b; assertEquals( ,c); System.out.println( +c); } { c=a*b; assertEquals( ,c); System.out.println( +c); } { c= ; System.out.println( ); } { System.out.println( ); } { String info = ; assertEquals(info, ); System.out.println( ); } } package import static import import import import import import public class JUnitAnnotations int 10 int 5 @BeforeClass public static void SetUpClass () //Initialization code goes here "This is @BeforeClass annotation" @Before public void SetUp () // Setting up the test environment "This is @Before annotation" @Test public void Addition () 15 "This is first @Test annotation method= " @Test public void Multiplication () 50 "This is second @Test annotation method= " @After public void TearDown () // Cleaning up the test environment null "This is @After annotation" @AfterClass public static void TearDownClass () //Release your resources here "This is @AfterClass annotation" @Ignore public void IgnoreMessage () "JUnit Annotation Blog" "JUnit Annotation Blog" "This is @Ignore annotation" Console Output Of JUnit Annotations in Selenium WebDriver Execution Sequence Of JUnit Annotations For Selenium A basic process flowchart of JUnit Annotations that would help you understanding the flow, step by step. Annotations In JUnit For Specific Purposes In earlier section we covered most basic JUnit annotations in Selenium. Now, I will show you some advanced JUnit annotations along with their specific purpose. @ParameterizedTest This annotation is somewhat similar to @Test annotation, the difference is that it is used to identify the parameterized test methods. We can also make use of @ValueSource annotation for providing the method parameters after annotating the test method. Keep in mind, that the data type for a parameters could be of any type such as String or Integer. In the below sample code, the variable “data” of String type passed as a parameter takes an argument from the source annotation. The primary purpose of this annotation is to run a test multiple times with different arguments. Note: Add the below libraries before using these annotation org.junit.jupiter.params.ParameterizedTest org.junit.jupiter.params.provider.ValueSource Example: (strings = { , , , }) { assertNotNull(data); } @ParameterizedTest @ValueSource "LambdaTest" "JUnit" "Annotations" "Blog" void ExampleCode (String data) Output: @RepeatedTest This annotation which has been introduced in JUnit 5 is used to run test method several times as per the requirement. The number of repetitions that you want a test to go under, can be passed as a parameter to @RepeatedTest annotation. Example ( ) { a= ; b= ; Object c; c= a+b; assertEquals( ,c); System.out.println( +c); } @Test @RepeatedTest 5 public void Addition () int 10 int 5 15 "This is @RepeatedTest annotation method= " Output @RunWith When a class is annotated with @RunWith annotation, JUnit invokes the class which are annotated to execute the test. This annotation basically runs with @SuiteClasses Annotation which specifies a group of many classes to be executed. Each class in a suite executes after the execution of prior running class. Note: It is necesarry to add org.junit.runner.RunWith librarby in order to use this annotation. Example (Suite.class) .SuiteClasses({ TestSample1.class, TestSample2.class, TestSample3.class, TestSample4.class, TestSample5.class, }) { } @RunWith @Suite public class JunitTest // This class remains empty, it is used only as a holder for the above annotations. @Parameters Note: Do not get confused between @ParameterizedTest annotation and @Parameters annotation. @Parameters annotation requires @RunWith annotation to specify that the test would run with Parameterized runner. However, in @ParameterizedTest annotations, @ValueSource would be used as a source annotation to pass arguments. While using @Parameters annotation, we use @RunWith annotation to specify that the test will run with Parameterized Runner. The runner looks for a method that initialize the test, provides values for the test and executes the test. In the below code, the value-set is defined as list Object arrays which is annotated with @Parameters. A parameterized test is a common test which is executed again and again using test parameters.This saves a lot of time for developers in executing the same test with different input types. Example (Parameterized.class) { String name, password; Object[][] getData() { Object[][] info = {{ , }, { , }}; info; } { .name = id; .password= pass; } { SampleCode.login(name, password); } } Below is the code SampleCode { { System.out.println(“Login credentials are ” + name + password ) ; } } @RunWith public class Blog1 @Parameters public "ramit1" "ramitd11" "ramit2" "ramitd22" return public Blog1 (String id, String pass) this this @Test public void Sample () for : class used in above example public class SampleCode public static void login (String name, String password) Output Attributes Used With JUnit Annotations In Selenium WebDriver These test annotations in JUnit have multiple attributes that can be used for our test method: 1) – To specify timeout for each test case, timeout attribute is specified within @Test annotation. Timeout time is specified in milliseconds. For example, suppose, you know your particular test case takes around 15-20 seconds to get executed and you want your test to fail if it takes more than 20 seconds to get executed, then you can use this attribute as @Test(timeout=20000) for your particular test case. If an execution fails then the progress bar would get red instead of green. timeout Example: (timeout= ) { System.setProperty( , ); WebDriver driver = ChromeDriver(); driver.get( ); driver.manage().window().maximize(); driver.findElement(By.xpath( )).click(); Thread.sleep( ); driver.findElement(By.xpath( )).sendKeys( ); driver.findElement(By.xpath( )).sendKeys( ); Thread.sleep( ); driver.quit(); } @Test 10000 InterruptedException public void ExampleCode () throws "webdriver.chrome.driver" "C:\\Users\\Lenovo-I7\\Desktop\\Selenium\\chromedriver.exe" new "https://www.lambdatest.com" "//*[@id=\'bs-example-navbar-collapse-1\']/ul/li[6]/a" 2000 //Login Page Button "//*[@id='app']/section/form/div/div/input[1]" "ramit@lambdatest.com" //Username "//*[@id=\'app\']/section/form/div/div/input[2]" "Hello1234" 2000 //Password Now, if you want to put this same timeout for multiple test cases, it is not necessary to add timeout attribute within each and every @Test annotation you have specified in your script. In such case, you can use @Rule annotation to define a global timeout that would be applicable for each @Test method annotation of your script. Example: Timeout globalTimeout = Timeout.seconds( ); @Rule public 10 // 10 seconds max per test method 2) – This is a special feature introduced by JUnit 4 which provides the facility to trace an exception that was expected from the execution of a particular code. There are different kinds of exceptions that are probably expected while running a code, such as, NoSuchMethodException, ArithmeticException, IndexOutOfBoundsExceptions etc. For example, you expect occurrence of exception from your code when a particular number is divided by zero, in this case, you would be using ArithmeticException. If the excepted exception does not occur then the test execution will fail. expected Example: (expected= ArithmeticException.class) { a= ,b= ,c; c=a/b; System.out.println( +c); } @Test public void ExampleCode () int 10 0 "Value= " Performing Cross Browser Testing with JUnit annotations On Selenium Grid Cross Browser Testing, as the name suggests, is a practice to test your website or web-application on different browsers, browser versions and on different operating systems as well, making sure that the particular application works as expected in desired configurations without any compromise in quality. Primarily, with browser compatibility testing, we test the appearance and functionality of a website. The purpose of cross browser testing is to provide consistent behavior of any application on different browsers, devices and platforms. Selenium helps us to perform automated cross browser testing for pacing our go-to-market delivery. Selenium comes under 4 variants - Selenium IDE Selenium RC Selenium WebDriver Selenium Grid would be the best option for automated cross browser testing, as it empowers users to perform parallel testing in Selenium for which we would be using Java with JUnit framework. For this, we would be running our automated test script on LambdaTest, a cross browser testing tool to realize the use of common JUnit annotations in Selenium by performing cross browser testing Selenium Grid Below is the code using which will first go to Apple’s website → iPad → iPad Air → Why iPad. Our code will then capture a screenshot of the last webpage i.e. Why iPad, and will store it in my local machine. I will be making use of LambdaTest Selenium Grid for running my below automation script to perform automated cross browser testing. LambdaAutoPack; java.io.File; java.io.IOException; java.net.MalformedURLException; java.net.URL; org.apache.commons.io.FileUtils; org.junit.After; org.junit.AfterClass; org.junit.Before; org.junit.BeforeClass; org.junit.Ignore; org.junit.Test; org.openqa.selenium.By; org.openqa.selenium.JavascriptExecutor; org.openqa.selenium.OutputType; org.openqa.selenium.TakesScreenshot; org.openqa.selenium.remote.DesiredCapabilities; org.openqa.selenium.remote.RemoteWebDriver; { String username = ; String accesskey = ; RemoteWebDriver driver = ; String gridURL = ; status = ; { System.out.println( ); System.out.println( ); } { DesiredCapabilities capabilities = DesiredCapabilities(); capabilities.setCapability( , ); capabilities.setCapability( , ); capabilities.setCapability( , ); capabilities.setCapability( , ); capabilities.setCapability( , ); capabilities.setCapability( , ); capabilities.setCapability( , ); capabilities.setCapability( , ); capabilities.setCapability( , ); capabilities.setCapability( , ); { driver = RemoteWebDriver( URL( + username + + accesskey + gridURL), capabilities); } (MalformedURLException e) { System.out.println( ); } (Exception e) { System.out.println(e.getMessage()); } } { { driver.get( ); driver.manage().window().maximize(); driver.findElement(By.xpath( )).click(); Thread.sleep( ); driver.findElement(By.cssSelector( )).click(); Thread.sleep( ); driver.findElement(By.linkText( )).click(); Thread.sleep( ); } (Exception e) { System.out.println(e.getMessage()); } } { (driver != ) { ((JavascriptExecutor) driver).executeScript( + status); } } { File screenshotFile = ((TakesScreenshot)driver).getScreenshotAs(OutputType.FILE); FileUtils.copyFile(screenshotFile, File( )); driver.quit(); } { System.out.println( ); } } package import import import import import import import import import import import import import import import import import public class JUnitAnnotation public "ramitdlambdatest" public "abcd1234" public static null public "@hub.lambdatest.com/wd/hub" boolean false @BeforeClass public static void setUpClass () "Cross Browser Testing on LambdaTest" "Testing on High Sierra, Chrome 72, Resolution-1920x1080" @Before Exception public void setUp () throws new "browserName" "Chrome" "version" "72.0" "platform" "macOS High Sierra" // If this cap isn't specified, it will just get the any available one "build" "JUnit Annotations" "name" "MyBlog" "network" true // To enable network logs "visual" true // To enable step by step screenshot "video" true // To enable video recording "console" true // To capture console logs "resolution" "1920x1080" try new new "https://" ":" catch "Invalid grid URL" catch @Test Exception public void testSimple () throws try "https://www.apple.com/" "//*[@id=\'ac-globalnav\']/div/ul[2]/li[3]" 2000 "#chapternav > div > ul > li.chapternav-item.chapternav-item-ipad-air > a" 2000 "Why iPad" 2000 catch @After Exception public void tearDown () throws if null "lambda-status=" @AfterClass IOException public static void teardownClass () throws new "D:\\Testing.png" @Ignore public void IgnoreMethod () "Some modules are not yet ready, please ignore" Code Walkthrough The above code will trigger my test in . If you wish to perform the test on some other browser + OS configuration then you can do so by simple changing the desired capabilities. LambdaTest provides a to help you with coded values based on your selections from drop-down list values. Google Chrome 72 on Mac High Sierra DesiredCapabilities Generator Since the method executes only once, I have mentioned the conclusion of this script there itself i.e. Cross Browser Testing on operating system-High Sierra, browser- Chrome, version-72 and resolution- 1920×1080 @BeforeClass annotation Coming to method, I have passed the desired capabilities from the capability generator provided by LambdaTest which defines the configurations(OS, Browser, Browser version, Resolution) on which you want your test to run on along with the desired Build name. The same capabilities would be used for each test method since the @Before annotation method executes before each test case. @Before annotation The method would include your test case of an application that you want to test. In this test method I have written a small automation script that would execute on LambdaTest Selenium Grid which includes live video streaming of selenium test and show the output on IDE console as well. You can create as many @Test annotation depending upon your different project test case executions. @Test annotation The method that executes after each test method shows the status of each test case that whether it has passed or failed. According to the status, you can decide whether the test case needs any improvisation or not. @After annotation The method which gets executed only once after the execution of all the test methods, would take the screenshot of the web page that was last accessible through the script and would save the screenshot in the mentioned directory/folder. @AfterClass annotation @Ignore annotation would just show that some modules of this particular web application has not been fully developed and are still in progress. So, the @Ignore annotation method won’t show any output. Output Below is the video that would show you the complete execution of my above automation test script on LambdaTest Selenium Grid. Summarizing It All! We have covered all the JUnit annotations in Selenium along with their explanation and sample code. We have also performed automated cross browser testing with the help of JUnit annotations in Selenium Grid on a cloud-based cross browser testing tool, LambdaTest. JUnit annotations are very powerful feature of JUnit, and help to improve code structure by making JUnit tests easier and more readable. Use of these annotations totally depends on your project requirement, using an appropriate annotation at correct place would be very helpful for developers as well as for other team members. Remember, would only work in JUnit 4 plus versions and would also require to import this particular library, “org.junit.” JUnit annotations for Selenium Execute your automation script using JUnit annotations on LambdaTest Selenium Grid now! Happy testing. 🙂 Previously published at https://www.lambdatest.com/blog/tutorial-on-junit-annotations-in-selenium-with-examples/