Web Automation Setup

Project Setup and Development Guide

• Open existing Maven project OR download sample project.
• Create cucumber test runner file under .../src/main/java for cucumber - BDD project for web application automation.

import static com.autoexsel.webdriver.WebDriverManager.*;

import org.testng.annotations.AfterSuite;

import cucumber.api.CucumberOptions;

import cucumber.api.testng.AbstractTestNGCucumberTests;

@CucumberOptions(features = "features/", glue = "autoexsel/cucumber/", tags = { "@verifyStepDef" })

public class WebTestRunner extends AbstractTestNGCucumberTests {

    @AfterSuite

    public void teardown() {

        closeExecution();

    }

}

• Create a package (e.g. autoexsel.cucumber.test) under .../src/test/java to maintain step definitions java file.
• Create a class file (e.g. CommonStepDefinition) under .../src/test/java and add below code snippet for reporting.

@Before

public void startTestReport(Scenario scenario) throws Exception {

    startTest(scenario.getName());

}

@After

public void endTestReport(Scenario scenario) {

    System.out.println(scenario.getName()+" :"+scenario.getStatus().toUpperCase()+"\n");

    endTest();

}

• Create a subfolder (e.g. features/module) under root and add feature files to test.
• Create other class files (e.g. LaunchAndOpen, PerformGoogleSearch) under .../src/test/java and add BDD step definitions.

AutoExSel provides many inbuilt functions which helps to automate web application along with API. Import below packages to use inbuilt functions.

import static com.autoexsel.webdriver.WebDriverManager.*;

import static com.factory.services.wrapper.RestAssuredManager.*;

• Refer and update config.json as required. Set api-testing as true for API testing along with functional, if required else don't create.
• Maintaining locators:
  • In line: Locators can be maintained in line of code e.g. findByAny("btnK").as("Button").click();
  • In Class: Locators can be maintained in class file...

public static String searchInput = "q";

public static String searchResult = "//h3[@class='LC20lb']";

And use variable name in line of code e.g. findByAny(searchInput).as("Search Field").sendKeys(arg1);

• In separate JSON: Create and update config.json if not created and add below

{

   "step-definition": "autoexsel.cucumber.test", //package name under .../src/test/java

   "or-path": "object-repositories"

}

Note: refer config.json and add/update the configuration keys value pair in configuration file as required. Value of step-definition can be autoexsel OR autoexsel.cucumber OR autoexsel.cucumber.test.

public static String searchInput;

public static String searchResult;

And use variable name in line of code e.g. findByAny(searchButton).as("Search Button").click();

• Maintain locators separately in json file under .../object-repositories/ as below:

{

   "searchButton": {

      "name": "btnK"

   }

}

IMPORTANT: Class file (where searchButton is used) and JSON file name must be same.

Static Functions Library

Actions & Validations Library