Skip to main content

When page object returns more than one type of page object

If have have been working with test automation then you would have probably heard of page objects. In a gist, page object provides clear separation of responsibility between who is responsible for testing (test classes) and who is responsible for services provided page (page classes). Page objects are known to return objects of same page when control retains on same page or another page object when operation on one page return object of another page. For example typing in a text box would keep control on same page (hence same page object) but submitting a form with valid data would most probably load a new page (hence a new page object).


But what if return type of Page Object is not fixed. For example for A/B variations, user may be directed to one of many possible variation of a page. Hence the resulting page is a page object but you don’t know for sure which age object. This is where java generics comes for rescue, and to be more specific generic methods.


Before delving into generic page object let’s see an example of generic method. If you have not worked with generic then java generic video tutorial will come handy.
Following example is a modified version of generic method. Let’s assume that we want to add a String element to given collection and return the modified collection. This could like as -


public Collection<String> addAndReturn(String element, Collection<String> collection) {
  collection.add(element);
  return collection;
}


But what if requirements change and we need to add Integer object to collection. Would we write another method which takes Integer argument? What if we need another method which takes a custom Object, would we write another method which takes our custom Object argument? The requirements are endless. This is when generic methods helps us achieving code reusability. We can write one generic method which takes argument of any type <T>, add it to a given collection of objects of type <T> and return the collection -


public <T> Collection<T> addAndReturn(T element, Collection<T> collection) {
  collection.add(element);
  return collection;
}


Herein <T> before the return type Collection<T> of method specifies a generic type. Notice that T is also the type of the element argument (T element) and collection argument (Collection<T> collection) of method. Now we can use this method to addAndReturn collection we want. The actual type of T is determined by the caller invoking addAndReturn method -


// add string to collection and return collection
Collection<String> stringCollection = new ArrayList<String>(Arrays.asList("a", "b","c"));
String string = "d";
System.out.println(addAndReturn(string, stringCollection));


// add int to collection and return collection
Collection<Integer> integerCollection = new ArrayList<Integer>(Arrays.asList(1, 2, 3));
int i = 4;
System.out.println(addAndReturn(i, integerCollection));


The concept of generic method can be applied to page object method as well when page object method may return a different page object -


public static <T extends PageObject> T getNewABPage() throws Exception {
  webElement.click();
  return (T) new PageObject();
}


Herein <T extends PageObject> is the generic type, which is PageObject type itself or any type which extends PageObject class in stf. You can either extend the PageObject or use object of your choice. Exact page type of page object can be derived either in test method or another page object which calls the generic page object method -


PageObject pageObject = getNewABPage();
// logic to determine exact type of page object, for ex using page title or
// element on page
// Once we know the exact page object type then down cast it to the required page object to carry out operation on required page object
((SendFeedbackPage)pageObject).enterFeedback("positive feedback");


Another example of generic page object method is when page object method is accessible from multiple pages but returns the instance of same page object on which it is called -


public static <T extends PageObject> T getSettingsPopup(T type) {
  webElement.click();
  return type;
}


And now any page can invoke settings popup and call the required operations on it


LoggedInUserHomePage loggedInUserHomePage = new LoggedInUserHomePage();
getSettingsPopup(loggedInUserHomePage).logout();

Can you think of more use cases when generic page object is useful ?

Popular posts from this blog

Distributed Load Testing with JMeter

Distributed Testing with JMeter When one JMeter client is not able to offer amount of threads required for load testing then distributed testing is used. In distributed testing - One instance of JMeter client can control number of JMeter instances and collect data from them Test plan does not need to be copied to each server, the client sends it to all servers note - JMeter will run all the threads on all the servers, hence 100 threads on 5 JMeter server would pump 500 threads in total. If many server instances are used, the client JMeter can become overloaded and so the client network connection. This has been improved in latest versions of JMeter by switching to Stripped modes, but you should always check that your client is not overloaded When Client (master) and Server (slave) nodes are on same network (no SSH required) Configure Client Node Herein client is referred as the machine controlling test execution on other JMeter nodes. This is also referred

Using chrome console to test xPath and css selectors

Since the advent of selenium there have been many plugin to test xPath / css selectors but you don’t need any of them if you have chrome browser. Using Chrome console you can test both xPath and css selectors. Launch website to be tested in chrome browser and hit F-12 and you would see chrome console opened in lower pane of application - Hit escape key and console would open another pane to write element locators - And now you can start writing xPath or css selectors in chrome console and test them - The syntax for writing css id - $$(“ ”) And hit the enter key. If your expression is right then html snippet of the application element corresponding to the css selector would be displayed - If you mouse over the html snippet in chrome console then it would highlight the corresponding element in application - If you want to clean console of previously written element selectors then just hit ctrl+L keys and chrome console would be empty again. Pro

XPath and single quotes

I had tough time dealing with XPath and single quote. Though W3C recommends using ' to escape it but I never got it working, let me know if any of you get through. Came across this blog and found that “concat” could be used in this situation. So original XPath expression is – //meta[@name=’DESCRIPTION’][@content=’Tester’s Test’] This is some thing which certainly fails as single quote in “Tester’s” marks it at end of string and then XPath blows up, next trial was – //meta[@name=’DESCRIPTION’][@content=’Tester''s Test’] This does not work despite w3c recommendation! And then I used concat function and split the string as – concat(‘Tester’,”’”,’s Test’) NOTICE that single quote is kept in double quote while other characters are kept in single quotes. So XPath looks as – //meta[@name=’DESCRIPTION’][@content=concat(‘Tester’,”’”,’s Test’)] And this works charm.