Skip to main content
Version: 1.22

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. They create a higher-level API which suits your application.

Page objects simplify maintenance. They capture element selectors in one place and create reusable code to avoid repetition.


Page object models wrap over a Playwright Page.

// models/
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");

API reference