Mokona

The goal of Mokona is to create layers of abstraction to facilitate selection of elements in tests using the Selenium WebDriver project

Get Mokona

Add the dependence in your pom.xml file

<dependency>
    <groupId>com.github.robsonbittencourt</groupId>
    <artifactId>mokona</artifactId>
    <version>0.1.0</version>
</dependency> 

Pages

If you use the Page Object pattern in your tests (i hope so) Mokona offers a way to facilitate the creation of these objects. For this create a class that will represent the page of your application and have it extend the Mokona class named MokonaPage.

public class GooglePage extends MokonaPage {

}

Elements

Elements should be classes in your project representing the visual elements such as buttons, links, and text fields. Mokona already has some basic elements of html, as mentioned above. To use them you must use the annotation @Element along with a selector that identifies the element on page. Mokona supports the same selectors available in the Selenium WebDriver, including the names are the same. Once declared on the page, no need to instantiate them, this is done automatically.

public class GooglePage extends MokonaPage {
	
	@Element(cssSelector="#lst-ib")
	TextField searchInput;
	
	@Element(cssSelector="[name=\"btnK\"]")
	Button searchButton;

	public void search(String textToSearch) {
	   searchInput.set(textToSearch);
	   searchButton.click(); 
	}

}

Create new Elements

If Mokona does not bring an element that you need to feel the will to create it. Simply create a new class that represents your element and have it extend the Mokona class named MokonaElement. Use getElement method to access the Selenium WebElement. Once created you can use it the same way as the native elements of Mokona. Of course, if your new element is generic, feel the will to submit a pull request.

public class MyAwesomeRadioButton extends MokonaElement {

	public void select() {
	   getElement().click();
	}

	public boolean isSelected() {
	   return getElement().isSelected();
	}

}

Configuration

To use Mokona is necessary to create a configuration file in the root of your project. This file should be called mokona.properties. For now the only configuration required is the location of your WebDriver. Supported drivers are ChromeDriver, Firefox Driver and Internet Explorer Driver. A sample configuration can be seen below:

mokona.path.chrome.driver=src/main/resources/chromedriver

If more than one driver is specified in the configuration file, Mokona use the following check order: ChromeDriver, FirefoxDriver, Internet Explorer Driver and the properties for driver configuration are:

mokona.path.chrome.driver
mokona.path.firefox.driver
mokona.path.ie.driver