/com.loliktest.ufit

Next Generation of UI Testing

Primary LanguageJava

UFit

Created By LolikTest

With love for Automation team!

Download

Maven Dependency

<dependency>
  <groupId>com.loliktest</groupId>
  <artifactId>ufit</artifactId>
  <version>0.0.6</version>
</dependency>

General Info

Elem - Simple HTML Element with selector (button, link, input, etc.)

CustomElem - Complex Element that can contains inside Elem, CustomElem, Elems<SomeItem>

Elems<SomeItem> - Collection of Page Items

Rules

  1. Do not use Thread.sleep()
  2. Use Only CssSelectors

How To Use

Elem

Forget about waits and complex actions

Declaration

   @Selector("input[name='q']")
   public Elem searchField;

Usage

     searchField.sendKeys(text);
     searchField.isPresent(10); // true
     searchField.isContainsText("Jack Sparrow", 0);
     searchField.assertion().isPresent(5);

CustomElem

Declaration

    @Selector("#nb_search") // Parent Selector
    public NavbarElem navigationBar;

NavbarElem.class

public class NavbarElem {

    @Selector("input[name='q']") //child
    public Elem searchField;

    @Selector("button") //child
    public Elem searchButton;

    @Step
    public SearchPage search(String text) {
        searchField.sendKeys(text);
        searchButton.click();
        return new SearchPage();
    }
}

Usage

    SearchPage searchPage = page.navigationBar.search("Star Wars");

Elems

Declaration

   @Selector(".lister-list > tr:nth-child(n)")
   public Elems<MovieItem> movieItems;

Usage

    List<MovieItem> movieItems = page.movieItems.get();
    movieItems.forEach(movie -> movie.title.assertion().isSelectionState(false, 0));

Page Example

All Pages MUST have constructor to init Elements:

public MyPage() {
    UFit.initPage(this);
}

Declaration

public class Top250Page {

    @Selector("h1.header")
    public Elem title;

    @Selector("#nb_search")
    public NavbarElem navigationBar;

    @Selector(".lister-list > tr")
    public Elems<MovieItem> movieItems;

    public Top250Page() {
        UFit.initPage(this);
    }

    @Step
    public double getMovieRatingByTitle(String movieTitle){
        return Double.parseDouble(movieItems.get(movie -> movie.title.getText().equals(movieTitle)).rating.getText());
    }
}

Usage

    Top250Page page = new Top250Page();
    double rating = page.getMovieRatingByTitle("The Godfather");
    Assert.assertEquals(rating, 9.1, "Movie Rating Not as Expected");

Browser Usage

UFit makes work with browser as simple as possible.

  1. Browser Opens on executing browser() method
  2. All your browsers will be closed on Test Suite finish event

By Default UFit uses Google Chrome Browser

You Can run your tests in parallel with TestNG and don't think about browser instances.

Each Thread will have it own browser.

Browser Configuration

If you want to customize Browser you can use simple way to store and use different configurations.

  1. Create class MyCustomBrowser that implements IBrowserConfig interface
  2. Add path to MyCustomBrowser in META-INF/services/com.loliktest.ufit.IBrowserConfig file in main/resources folder
  3. Set <parameter name="browser" value="MyCustomBrowser"></parameter> parameter at Suite Level in TestNG.xml file

Example

Create class MyCustomBrowser that implements IBrowserConfig interface

public class MyCustomBrowser implements IBrowserConfig {

    @Override
    public WebDriver setupDriver() {
        ChromeOptions options = new ChromeOptions();
        Map<String, String> mobileEmulation = new HashMap<>();
        mobileEmulation.put("deviceName", "iPhone 8");
        options.setExperimentalOption("mobileEmulation", mobileEmulation);
        return new ChromeDriver(options);
    }

}

Add path to MyCustomBrowser in META-INF/services/com.loliktest.ufit.IBrowserConfig file in main/resources folder

com.loliktest.ufit.browsers.MyCustomBrowser

Set parameter browser at Suite Level in TestNG.xml file

<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
<suite name="MySuite" parallel="tests" thread-count="5">
    <parameter name="browser" value="MyCustomBrowser"></parameter>
    <test name="Login">
        <classes>
            <class name="com.project.tests.LoginTest"></class>
        </classes>
    </test>
</suite>