Automation Testing With Selenium, Cucumber Tool And TestNG

Cucumber is a test automation framework which leverages Behavior Driven Development for collaboration in between Business and IT teams. It empowers a user to define an application’s behavior in plain English language which makes it easier for non-programmers to understand the acceptance criteria. The core of Cucumber has been developed in Ruby programming language however it supports all the majorly used programming languages for testing such as Java, C#, Python. In this article, I will be demonstrating automation testing with Selenium, Cucumber and TestNG. What Is Behavior Driven Development? Behavior Driven Development is derived from Test Driven Development as a software development methodology. As a part of the Test Driven Development approach, the developer creates tests as a part of the acceptance criteria first. The developer will make sure the test is passed and will commit changes in the code. if required. Test Driven Development is a way to ensure the system meets its requirements by ensuring a 100% test coverage. It provides an edge over other methodologies in terms of finding defects early in the cycle which reduces the cost of finding bugs and refactoring improves the code. Cons of Test Driven Development are the maintenance of tests created, it is a test-centric methodology, non-programmers might find it hard to understand for performing . The test or acceptance criteria being targeted makes it hard for team collaboration. To overcome the above trouble heads, Behavior Driven Development was introduced to reduce the time to test, less code with more collaboration. selenium test automation Advantages Of Using BDD For Automation Testing With Selenium & Cucumber : Bridges the communication gap between stakeholder or business teams who can’t easily understand or read the code. This problem is addressed by defining the behavior of application under test in a ubiquitous language i.e. easily understandable. Collaborative Approach Focuses more in terms of end-user experience or inclined more towards behavior specifications while compared to that of traditional Test Driven methodology. Tests are written more from end user’s point of view, making them easier to understand for performing Selenium automation testing. How Cucumber Leverages BDD For Selenium Automation Testing? As discussed earlier, Cucumber is a test automation tool that supports Behavior Driven Development. It makes use of user-defined specifications to validate the application under test. Before we step into performing automation testing with Selenium & Cucumber, let me tell you about the three major parts of the cucumber framework i.e. , and . Feature file, Step Definitions Test Runner file Feature File would enable the user to define the behavior of the application in plain English text with help of Gherkin Language. Gherkin is used to define executable specifications with the help of a predefined set of contextual keywords. Keywords involved are demonstrated with the help of the below example: Feature: High-level description of a software feature or behavior of application under test. Scenario: Feature file can contain more than one scenario which acts as a test case derived from test scenarios/behaviors. It also symbolizes and acts as one or more user perspectives involved. Annotations: Keywords which hold a specific meaning and would help and defined the meaning of a scenario. Sample keywords involved are GIVEN, WHEN, THEN & AND. : Define pre-requisites of the application. GIVEN : Trigger point for a scenario execution can be related more towards steps to be executed. WHEN : Defined an outcome more like the expected result. THEN : Acts as a logical bridge AND in between two statements. AND Scenario Outline: It’s a template provided to carry out scenario execution, test data table provided in the Examples section would replace variables/arguments created making each individual row in a table as a unique scenario. : It paves the way to organize your tests based on your tag definition. Tags Quoted an example related to the feature file below which involves all the above-mentioned keywords. Feature: Place order on the Amazon website. Scenario: Validate the guest user is able to add a product to cart. GIVEN user is logged onto the Amazon website as a guest user. WHEN user searches a product on the homepage. THEN user should be able to view product information related to product searched. AND user click on add to cart button THEN user verifies the product is added to cart

Scenario Outline: Validate a registered user is able to place an order. GIVEN user is logged onto the Amazon website as a registered user. WHEN user logs in with and THEN user should be able to view homepage. WHEN user searches THEN user should be on the product information page. AND user tried to add the product to cart THEN product should be added to cart. WHEN user navigates to order confirmation page via express checkout option. THEN order should be placed successfully along with order confirmation id being generated. @SmokeTest if if if for created would be consisting of a code which defines the steps for annotations created in feature file. An annotation followed by step defined in patterns with the help of regular expression would help in linking the step definition file to steps in feature file. Sample step definition code sample for above code is defined as above. Step Definition file ( ) { driver = FirefoxDriver(); driver.manage().timeouts().implicitlyWait( , TimeUnit.SECONDS); driver.get( ); } ( ) { driver.findElement(By.xpath( )).click(); } @Given "^user is logged onto Amazon website as a guest user $" Throwable public void user_is_on_Home_Page () throws new 5 "http://www.amazon.in" @When "^user searches a product on homepage $" Throwable public void user_searches_a_product () throws ".//*[@id='account']/a" defined the location of step definition and primarily provides all the metadata information required for test execution. It makes use of ‘@RunWith()’ annotation from JUnit framework for execution. Secondarily you would be making use of ‘@CucumberOptions’ annotation to define the location of feature files, step definitions location through glue, what reporting integrations to use etc. Test Runner file Below is the sample of feature file created. amazonTest; org.junit.runner.RunWith; cucumber.api.CucumberOptions; cucumber.api.junit.Cucumber; (Cucumber.class) ( features = ,glue={ } ) {

} package import import import @RunWith @CucumberOptions "src/test/Feature" "src/main/stepDefinition" public class TestRunner We can integrate parallel test execution for automation testing with Selenium & Cucumber framework for saving a considerable amount of time during test execution. To elaborate the above scenario, serve the regression test needs of an application under test you have to execute your entire regression test automation repository which could serve you with both time and resource constraints. The end-user would not be using the same browser with its latest version, there could be plenty of browsers, operating systems and browser version combinations which should be considered while performing out testing. However, the cons stated above could be resolve with cloud solutions such as LambdaTest which is a cloud. LambdaTest offers an online Selenium grid consisting 2000+ real browsers and operating systems help you achieve maximum amount of browser test coverage. Build time could be drastically reduced by utilizing LambdaTest automation for your test execution. Parallel test execution with the help of various browsers and multiple versions of each browser instance would help you achieve your cross browser parallel testing needs. Automated screenshots and video recording would help you keep track of your test failures and find the root cause quickly providing you a better analytical perspective while troubleshooting. cross browser testing As we have embarked on our journey of implementing automation testing with Selenium & Cucumber framework using Java, till now we have learned the overview of the cucumber framework and how it leverages BDD. Let’s get into hands-on the mode by creating a sample framework using Cucumber for Selenium automation. Creating Your First Project Using Cucumber For Selenium Automation Testing We make use of Eclipse IDE for coding purposes, get the latest version from their official website . https://www.eclipse.org/downloads/ “cucumber-archetype Artifact Id Group Id as io.cucumber” Archetype would be generated with the help of above statement. If in case above archetype has been missing please add template for the Archetype by entering below info. GroupId: “io.cucumber” ArtifactId: “cucumber-archetype” Version: “2.3.1.2” After entering above details try navigating further and finishing required steps. Hence maven project would be successfully created. Replace the dependencies by obtaining them from below pom file as required with below set of dependencies.

.0 Google_Search Google_Search .1-SNAPSHOT jar Google_Search http: UTF- org.seleniumhq.selenium selenium-java .0 junit junit test io.cucumber cucumber-java .2 com.google.guava guava .1-jre io.cucumber cucumber-junit .2 test "http://maven.apache.org/POM/4.0.0" "http://www.w3.org/2001/XMLSchema-instance" "http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" 4.0 0.0 //maven.apache.org 8 3.14 4.12 4.2 27.0 4.2 Creating your Feature file with user defined specifications in Gherkin Language: : Create a folder for organizing all your feature files as shown in the image below. : Select File from the navigation menu. File → New → File. : Name the file using “Login.feature”. : As there is no plugin which supports “.feature” extension file created would look as in the image below. Step 1 Step 2 Step 3 Step 4 : Once you create the feature file below alert would be prompted asking you to select the editor to be installed from the marketplace. Step 5 : Select “Show IDE extensions for this file type and let me install them” radio button and select the first option which is Cucumber Eclipse Plugin as shown in the image below. Click on install. Accept the terms of the license agreement. Click on Finish. You would be prompted with a security alert, click on Install Anyway option, once installation is finished click on Restart Now to view the changes made. Step 6 : To view if changes are reflected observe the Feature file as in below image how different is it from the previous image of the feature file created. Step 7 Running First Script Of Automated Testing With Selenium & Cucumber Framework Let’s consider a real-world case study of querying a search term in google search by creating a feature file which consists of feature, tags and scenarios and scenario outline as applicable. For automation testing with Selenium & Cucumber framework for Java, we need to create a file under with below content under “ . GoogleSearch.feature Features package src/test/java” path Feature: Searching Google should the name of query

Scenario: Google search with scenario Given user launches Google webapp When user searches a And click on search button Then results retrieved should contain the used

Scenario Outline: Searching google using scenario outline and examples Given user launches Google webapp When user searches a And click on search button Then results retrieved should contain the used return for "LambdaTest" "LambdaTest" for " " " " Once you have completed creating a feature file, created steps would be highlighted with warnings indicating that you haven’t defined the step contained in step definition file yet. In order to resolve the errors, lets navigate to the step definition file to complete coding the gist which defines our steps. Below code can be replaced in step definition file which is Stepdefs. : TIP While creating your step definitions if you want a template for step definitions file creation just run the feature file along with warnings as discussed previously. It would provide you with the template upon which you can start coding as shown in the image below. Make sure your step definitions are specified in package “com.googlesearch.testing.steps” under the path of “ ”. src/main/java Copy the code and define the path to your chrome driver. Below is the code used for automation testing with Selenium & Cucumber in Java. com.googlesearch.testing.steps; org.openqa.selenium.By; org.openqa.selenium.WebDriver; org.openqa.selenium.WebElement; org.openqa.selenium.chrome.ChromeDriver; cucumber.api.java.en.And; cucumber.api.java.en.Given; cucumber.api.java.en.Then; cucumber.api.java.en.When; { WebDriver driver; String baseURL = ; ( ) { System.setProperty( , ); driver = ChromeDriver(); driver.manage().window().maximize(); driver.get(baseURL); } ( ) { WebElement searchBox = driver.findElement(By.name( )); searchBox.sendKeys(arg1); } ( ) { WebElement searchBox = driver.findElement(By.name( )); searchBox.submit(); } ( ) { WebElement result = driver.findElement(By.className( )); (resultString.equalsIgnoreCase(result.getText())) { System.out.println( ); } { System.out.println( );

} driver.quit(); }

} package import import import import import import import import public class stepDefinitions public static "https://www.google.com" @Given "^user launches Google webapp$" Throwable public void user_launches_Google_webapp () throws // Write code here that turns the phrase above into concrete actions "webdriver.chrome.driver" "C:\\Cucumber_Workspace\\GoogleSearch\\Libs\\chromedriver.exe" new @When "^user searches for a \"([^\"]*)\"$" Throwable public void user_searches_for_a (String arg1) throws "q" @And "^click on search button$" Throwable public void click_on_search_button () throws "q" @Then "^results retreived should contain the \"([^\"]*)\" used$" Throwable public void results_retreived_should_contain_the_used (String resultString) throws "LC20lb" if "Text is matching" else "Text is not matching" Make sure your Test Runner java file which is named as RunCucumberTest is under “src/test/java” path with code specified below. org.junit.runner.RunWith; cucumber.api.CucumberOptions; cucumber.api.junit.Cucumber; (Cucumber.class) (features = { }, plugin = { , }) {

} import import import @RunWith @CucumberOptions "classpath:features" "pretty" "json:target/cucumber/cucumber.json" public class RunCucumberTest Now you have all the 3 main aspects ready for test execution. To proceed further for running automation testing with Selenium and Cucumber you would need to right-click on RunCucumberTest.java file which is created. Click on Run as JUnit Test. Tests get triggered for both the scenarios specified. If you observe the scenario outline it gets executed thrice with all the sets of data specified in a data driven format. Using LamdaTest For Automation Testing With Selenium & Cucumber Above test would be running in sequence and nexttest would have to wait till the thread is empty by completion of previous test triggered. This would consume more amount of time and cross browser testing with above methodology would prove to be a troublesome and expensive due to the permutations and combinations of the browsers and operating systems and versions available. In order to overcome the issue we would have to run our automation tests with Selenium and Cucumber in parallel, even if we do so still we would have to configure a lot of machines as the number of tests you can trigger per system would depend on the computing capabilities of each system. LambdaTest would help us overcome the above problem statements. As a cloud solution it offers scalability to reduces build time, improve browser test coverage, provision to validate from pixel to pixel accuracy, enhanced reporting and analytical capabilities. Let’s start with configuring Cucumber to enable parallel test execution of Selenium with Java using LambdaTest for automated cross browser testing responsiveness of a web app Configuring Your Test Suite With LambdaTest For Parallel Test Execution Of Selenium With Cucumber & TestNG Replace your step definition file with below code which includes Remote WebDriver configuration to connect to cloud virtual machines. Currently we have JUnit as our unit testing framework, for provisioning parallel test execution let’s integrate current framework with TestNG. TestNG provides an easier configuration and additional capabilities which makes it more powerful than that of JUnit. We start with creating a TestNG xml file to run the test suite. Add below xml code to your project root folder. If you are not familiar with TestNG then you can have a look at our guide for running first TestNG automation script. "1.0" "UTF-8" "http://testng.org/testng-1.0.dtd" "GoogleSearch" "tests" "3" "WIN10TEST_FF" "browser" "Firefox" "version" "64.0" class name "com.cucumber.tests.TestNGRunCucumberTest" "WIN10TEST_CHROME" "browser" "Chrome" "version" "71.0" class name "com.cucumber.tests.TestNGRunCucumberTest" Replace your step definition file with below code. @Parameters will help us to parameterize the desired capabilities such as browsername, version, platform etc. Have a look at LambdaTest Capabilities Generator for fetching the coded values according to your desired capabilities. If you take a glance at above xml file we have two parameters which are browser and version. Thread count in the xml code represents the number of concurrent session which are possible. We have set it to 2 for demo purposes. Kindly replace the stepDefinition code with below TestNG model. com.cucumber.stepdefs; org.openqa.selenium.By; org.openqa.selenium.WebElement; com.cucumber.tests.TestNGRunCucumberTest; cucumber.api.java.en.And; cucumber.api.java.en.Given; cucumber.api.java.en.Then; cucumber.api.java.en.When; { ( ) { driver.get(baseURL); } ( ) { WebElement searchBox = driver.findElement(By.name( )); searchBox.sendKeys(arg1); } ( ) { WebElement searchBox = driver.findElement(By.name( )); searchBox.submit(); } ( ) { WebElement result = driver.findElement(By.xpath( )); (result.isDisplayed()) { System.out.println( ); } { System.out.println( ); } } } package import import import import import import import public class stepDefinitions extends TestNGRunCucumberTest @Given "^user launches Google webapp$" Throwable public void user_launches_Google_webapp () throws // Write code here that turns the phrase above into concrete actions @When "^user searches for a \"([^\"]*)\"$" Throwable public void user_searches_for_a (String arg1) throws "q" @And "^click on search button$" Throwable public void click_on_search_button () throws "q" @Then "^results retreived should contain the \"([^\"]*)\" used$" Throwable public void results_retreived_should_contain_the_used (String resultString) throws "//*[@id='rhscol'][1]" if "Resutls are retreived" else "Resutls are not retreived" As we have trigger the tests from xml file of TestNG we can replace the TestRunner file with below code, as our entry point would be TestNGRunner xml. com.cucumber.stepdefs; org.openqa.selenium.By; org.openqa.selenium.WebElement; com.cucumber.tests.TestNGRunCucumberTest; cucumber.api.java.en.And; cucumber.api.java.en.Given; cucumber.api.java.en.Then; cucumber.api.java.en.When; { ( ) { driver.get(baseURL); } ( ) { WebElement searchBox = driver.findElement(By.name( )); searchBox.sendKeys(arg1); } ( ) { WebElement searchBox = driver.findElement(By.name( )); searchBox.submit(); } ( ) { WebElement result = driver.findElement(By.xpath( )); (result.isDisplayed()) { System.out.println( ); } { System.out.println( ); } } } As we have trigger the tests from xml file of TestNG we can replace the TestRunner file with below code, as our entry point would be TestNGRunner xml. com.cucumber.tests; java.net.MalformedURLException; java.net.URL; org.openqa.selenium.remote.DesiredCapabilities; org.openqa.selenium.remote.RemoteWebDriver; org.testng.annotations.AfterClass; org.testng.annotations.BeforeClass; org.testng.annotations.DataProvider; org.testng.annotations.Parameters; org.testng.annotations.Test; cucumber.api.CucumberOptions; cucumber.api.testng.CucumberFeatureWrapper; cucumber.api.testng.PickleEventWrapper; cucumber.api.testng.TestNGCucumberRunner; (features = { }, glue = { }, plugin = { , }) {

DesiredCapabilities capabilities = DesiredCapabilities();

String username = ; String accesskey = ; RemoteWebDriver driver = ; String gridURL = ; status = ; String baseURL = ; TestNGCucumberRunner testNGCucumberRunner; (value = { , }) { capabilities.setCapability( , ); capabilities.setCapability( , ); capabilities.setCapability( , ); capabilities.setCapability( , browser); capabilities.setCapability( , version); { driver = RemoteWebDriver( URL( + username + + accesskey + gridURL), capabilities); } (MalformedURLException e) { System.out.println( ); } (Exception e) { System.out.println(e.getMessage()); } testNGCucumberRunner = TestNGCucumberRunner( .getClass()); } (groups = , description = , dataProvider = ) { testNGCucumberRunner.runScenario(pickleEvent.getPickleEvent()); } Object[][] scenarios() { testNGCucumberRunner.provideScenarios(); } { driver.quit(); testNGCucumberRunner.finish(); } } package import import import import import import import public class stepDefinitions extends TestNGRunCucumberTest @Given "^user launches Google webapp$" Throwable public void user_launches_Google_webapp () throws // Write code here that turns the phrase above into concrete actions @When "^user searches for a \"([^\"]*)\"$" Throwable public void user_searches_for_a (String arg1) throws "q" @And "^click on search button$" Throwable public void click_on_search_button () throws "q" @Then "^results retreived should contain the \"([^\"]*)\" used$" Throwable public void results_retreived_should_contain_the_used (String resultString) throws "//*[@id='rhscol'][1]" if "Resutls are retreived" else "Resutls are not retreived" package import import import import import import import import import import import import import @CucumberOptions "src/test/java/features" "com.cucumber.stepdefs" "pretty" "json:target/cucumber/cucumber.json" public class TestNGRunCucumberTest new " bharadwajpendyala" " qYlLn1IzVrC2U41zM4kyjv35EvpHxR2tyMB4aEBlkNMmvpnQ5A" protected static null "@hub.lambdatest.com/wd/hub" boolean false protected "https://www.google.com" private @BeforeClass @Parameters "browser" "version" public void beforeClass (String browser, version) float "build" "Cucumber_Project" "name" "Querying in google engine" "platform" "Windows 10" "browserName" "version" try new new "https://" ":" catch "Invalid grid URL" catch new this @Test "cucumber scenarios" "Runs Cucumber Scenarios" "scenarios" Throwable public void scenario (PickleEventWrapper pickleEvent, CucumberFeatureWrapper cucumberFeature) throws /** * returns two dimensional array of { CucumberFeatureWrapper} * objects. */ @return @link @DataProvider public return @AfterClass public void tearDown () After executing the above code for performing automation testing with Selenium, Cucumber, & TestNG. It is important to observe the details of your Selenium automation tests. LambdaTest provides every inch of information, from analytics to video logs for you to observe the output of your automation testing with Selenium. Automation Dashboard: Navigate to automation dashboard of lambdatest engine to view number of concurrent sessions being active and browser info as highlighted in the above screenshot. It provides the logs, metadata information, screenshots and video recording for the tests executed. Click on test to view the details specified above as in below snapshot. Analytics View: Analytical view of tests execution information could be viewed by click on analytics tab. This would provide a comprehensive view of builds passed, failed, day of execution, time taken, bugs logged from the testing etc. You can take a glance at it in the below image. Timeline View: Timeline would provide the information of test suite executed as a whole. Time and date of execution browser information, failures and error information if any. You can view tests executed in the form of build or test view. To summarize we have explained what is cucumber, how does it help overcome challenges of traditional test methodologies. We have ran our first test script framework after understanding what cross browser testing is all about. Also, how cross browser testing could be simplified using parallel cloud testing solution like LambdaTest. We have created a cucumber framework and configured it with LambdaTest integrating TestNG for parallel testing. automation testing with Selenium and Cucumber Previously published at https://www.lambdatest.com/blog/automation-testing-with-selenium-cucumber-testng/