Version: Next

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/
class SearchPage:
def __init__(self, page): = page
def navigate(self):"")
def search(self, text):'[aria-label="Enter your search term"]', text)'[aria-label="Enter your search term"]', "Enter")

Page objects can then be used inside a test.

from import SearchPage
# in the test
page = browser.new_page()
search_page = SearchPage(page)
search_page.navigate()"search query")

API reference#