• chrome

• firefox

• chrome headless

• iexplorer

• gradle
• Cucumber for Java plugin for IntelliJ
• Gherkin for IntelliJ
• chromedriver.exe (put it into project root)- chrome is set as default browser
• geckodriver.exe (put it into project root)- is needed for newer FF versions
• IEDriverServer.exe (put it into project root)

• clone repository
• open build.gradle file in IDE (IntelliJ)
• import dependencies with gradle

• add your .feature files with scenarios
• create custom steps class / steps classes with @Autowired annotations for page objects class / classes
• generate steps- in .feature file press 'alt+enter' shortcut and choose 'Create step definition' option, choose created steps class / steps classes to paste steps
• create custom page objects classes with methods and with @Component and @Autowired annotations for webdriver manager
• create assertions classes with methods and @Component annotation
• delete example .feature files, steps classes, page objects classes and assertion classes

Add @PageObject in page object classes instead of Spring @Component annotation

Steps classes implements En interface and are prepared to use code by 'lambda-way'. Example of lambda expression is used in SignUpFormPageObjects class:

    private void sendKeysForInputWithAttrubuteName(String partValueName, String keyToSend){
        webDriverManager.getDriver().findElements(By.cssSelector(USER_INPUT))
                .stream()
                .filter(elem->elem.getAttribute(USER_INPUT_ATTRIBUTE_NAME).contains(partValueName))
                .findFirst()
                .get()
                .sendKeys(keyToSend);
    }

If there is a need to use Selenide as a driver provider to find elements or take an action, simply add one line in a page object method:

WebDriverRunner.setWebDriver(your initialized driver);

A method in template, which is using Selenide to find element might look like below (there is used 'setWebDriver(driver)' method):

    @Autowired
    private WebDriverManager webDriverManager;

    private static final String JAM_MENU = ".Header-nav-item[href*=jam]";

    public void clickJamMenu(){
        WebDriverRunner.setWebDriver(webDriverManager.getDriver());
        $(JAM_MENU).click();
    }

Or paste the method 'setWebDriver(driver)' in the WebDriverManager class like below and use Selenide as a driver provider across the project, mixing it with Selenium WebDriver (you can use both in methods):

            (...)
            default:
                System.getProperty("browser", "chrome");
                System.setProperty("webdriver.chrome.driver", "chromedriver.exe");
                webDriver = new ChromeDriver();
                break;
        }
        WebDriverRunner.setWebDriver(webDriver);
        return webDriver;
    }

The method 'getWebDriver()' in WebDriverManager class is already configured to use Selenide library. You can choose which way Selenide is going to be used in project (only partially in particular method or globally with WebDriverManager class)

 runTests

-Dbrowser=chrome runTests

-Dbrowser=firefox runTests

-Dbrowser=chromeHeadless runTests

-Dbrowser=iexplorer runTests

clean test

clean -Dbrowser=chrome test

clean -Dbrowser=firefox test

clean -Dbrowser=chromeHeadless test

clean -Dbrowser=iexplorer test

run CucumberRunner class

or run .feature file / directory with .feature files / scenario in .feature file

Reports are placed in 'target' directory, including screenshots of failed scenarios. To run report in browser, open 'target\html\index.html' file and choose browser.

• runTests
• deleteCucumberReports