What are the benefits of returning new page object in page object pattern?

Question

For example, if I were to test Google search, what is the benefit of the Page Object model returning new Google Search Page Object?

E.g.

public class SearchPage {
    private final WebDriver driver;

    public SearchPage(WebDriver driver) {
        this.driver = driver;
    }

    public SearchPage search(String query) {
        WebElement e = driver.findElement(By.name("q")).sendKeys(query);
        e.submit();

        return new SearchPage(driver);
    }
}

vs

public class SearchPage {
    private final WebDriver driver;

    public SearchPage(WebDriver driver) {
        this.driver = driver;
    }

    public void search(String query) {
        WebElement e = driver.findElement(By.name("q")).sendKeys(query);
        e.submit();
    }
}

Thanks for the help!

score 2 · Accepted Answer · answered Aug 29 '12 at 06:21

2

One thing that comes to my mind is chaining the methods from SearchPage class. When you would have lets say some higher level class that is responsible for running the tests you could use sth like this:

String actualText = searchPage.search("q").openFirstResult().selectItemFromCombo().checkName().getNameText()

etc. etc.

This makes reading your code very easy, looks almost like a sentence and it is understandable for othe people.

answered Aug 29 '12 at 06:21

Arek

1,941
4
22
27

You can argue whether such chained (or "fluent") calls are a good or bad idea, but yes, that's exactly why this is normal. – Ross Patterson Aug 29 '12 at 15:53

What are the benefits of returning new page object in page object pattern?

1 Answers1