Feature Object Pattern

, Author: Cezary Piątek


When it comes to writing maintainable UI test there always appears the term of Page Object Pattern. For those who are not familiar with Page Object, it’s the approach to building UI test that focuses on creating high-level abstraction over low-level details related to interaction with a tested application. This testing interface encapsulates all the noise related to technology and allows to clearly express intention of test cases. This concept is very well described by Martin Fowler here.

Page Objects can be prepared by programmers who participate in development of tested application. This approach is very efficient because the programmer knows best the implementation details, how particular elements were built and how to interact with them. Such Page Object can be then used by testers to automate test cases. I think this is the most effective way of preparing automatic UI tests because everybody does what they know best. A testing person is excused from the need of getting to know how the tested app is built, how the used technology works and they can focus entirely on automatig test cases using high level testing api.

Introduction of Feature Object 🔗︎

A page object wraps a HTML page, or fragment, with an application-specific API, allowing you to manipulate page elements without digging around in the HTML.

This is a quote from Martin Fowler’s Page Object description. We can take it a little further by applying the divide and conquer rule and introduce a new kind of object that represents a single type of building element appearing repeatedly in tested application. These can be objects such as lists, tables, trees, forms etc. I call this kind of wrapper a Feature Object Pattern. This approach has a few benefits. It allows to program interaction with given type of element only once and reuse it everywhere in the tests. We can use Feature Object to compose Page Object of them by adding contextual integration. When a given type of element changes, it only requires modificaion in one place. One of the positive side effects is that it enforces on the programmers to build the application in a consistent way (all list, tables, forms etc should be constructed and behave consistently). This is a counterpart of the component approach in application development. Each component (or set of components) should be reflected by Feature Object. Before we start writing a UI test, we should perform analysis by identifying the application building elements and prepare the appropriate Feature Object for them. Similar to Page Object, in order to make the process more efficient, they should be prepared by the developer.

Implementing Feature Objects 🔗︎

I’ve made an attempt of implementing generic Feature Objects for elements such as forms, lists, tables and trees in my Selenium wrapper called Tellurium which is available on Github. A sample usage of these Feature Objects is described on the project’s wiki in the following sections:

If you are interested in implementation details, please inspect source code of the following classes: WebTree, WebList, WebTable and WebForm. This project is written in C#, but I’m pretty sure that these classes can be easily ported to your programming language of choice.

Let’s look how we can handle tables using WebTable wrapper from Tellurium project:

var table = browserAdapter.GetTableWithId("SampleTable");
table[1] //access second row
table[1][0].Text //access second row, first column
table[1][0].Text //access second row, first column cell's text
table[0]["Column Name"].Text //access first row, column with caption  "Column Name" 

table.First() //access first row
table.First().First() //access first row, first column
table.Last().Last() //access last row, last column
table.FindItemWithText("Example row")[1] //access row with text "Example row", second colum

As we see, this is a very simple, elegant, intuitive and readable way of interacting with tables. We don’t need to know how the table was built, what the underlying markup looks like and what do particular tags mean. Another interesting example shows how easily we can work with forms using WebForm wrapper:

var loginForm = browserAdapter.GetForm("RegistrationForm");
loginForm.SetFieldValueByLabel("First name", "John");
loginForm.SetFieldValueByLabel("Last name", "Doe");
loginForm.ClickOnElementWithText("Register");

Building Page Object from Feature Objects 🔗︎

Having Feature Objectsrepresenting forms and lists, we can use them to build Page Object for user list with filters:

public class UserListPage()
{
  private readonly Lazy<WebForm> filterForm;
  private readonly Lazy<WebList> userList;
  private readonly new Lazy<WebList> listPagination;

  public UserListPage(WebDriver  driver){    
    this.filterForm = new Lazy<WebForm>(x => driver.FindFormWithId("UserFilterForm"));
    this.userList = new Lazy<WebList>(x => driver.FindListWithId("UserList"));
    this.listPagination = new Lazy<WebList>(x => driver.FindListWithId("UserListPagination"));
  }

  public void FilterWith(Action<Form> fillFilterFormAction)
  {
      fillFilterFormAction(this.filterForm);
      this.filterForm.Value.ClickOnElementWithText("Filter");
  }

  public void LoadPage(int pageNo){
      this.listPagination.Value.ClickOnElementWithText($"{pageNo}");
  }

  public int GetNumberOfUsers(){
    return this.userList.Value.Count;
  }

  public void OpenUserDetails(string userName)
  {
      var listItem =  this.userList.Value.FindItemWithText(userName);
      listItem.ClickOnElementWithText("Details");
  }
}

In this example Feature Objects were used to handle the following page elements:

  • filter form
  • list of users
  • pagination bar (list of page numbers).

With our Page Object we can easily create a test that is very concise and readable:

[Test]
public void should_be_able_to_filter_users()
{  
  //ARRANGE
  var driver = this.GetDriver();
  var userList = driver.GoToUserList();

  //ACT
  userList.FilterWith(filter => {
    filter.SetFieldValueByLabel("Department", "Security");
    filter.SetFieldValueByLabel("Severity", "Senior");
  });

  //ASSERT
  Assert.AreEquals(5, userList.GetNumberOfUsers())
}

Summary 🔗︎

If you want to create maintainable UI Tests, you should definitely utilize Page Object Pattern in conjunction with Feature Object Pattern. In order to make the process of preparing UI Tests more effective, the people responsible for automating test cases should be supported by programmers developing tested application and building appropriate Page Objects and Feature Objects. If you don’t know how to start building Feature Objects you can check the implementations of WebTree, WebList, WebTable and WebForm from Tellurium Project. I used it to automate tests for the application that consist of 100+ forms and it works like a charm.


Products recommended for highly effective .NET Developers:


comments powered by Disqus

See Also