Skip to main content

Page object models


Large test suites can be structured to optimize ease of authoring and maintenance. Page object models are one such approach to structure your test suite.

A page object represents a part of your web application. An e-commerce web application might have a home page, a listings page and a checkout page. Each of them can be represented by page object models.

Page objects simplify authoring by creating a higher-level API which suits your application and simplify maintenance by capturing element selectors in one place and create reusable code to avoid repetition.


Page object models wrap over a Playwright Page.

package models;


public class SearchPage {
private final Page page;
private final Locator searchTermInput;

public SearchPage(Page page) { = page;
this.searchTermInput = page.locator("[aria-label='Enter your search term']");

public void navigate() {

public void search(String text) {

Page objects can then be used inside a test.

import models.SearchPage;

// In the test
Page page = browser.newPage();
SearchPage searchPage = new SearchPage(page);
searchPage.navigate();"search query");