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.

using System.Threading.Tasks;
using Microsoft.Playwright;

namespace BigEcommerceApp.Tests.Models;

public class SearchPage
private readonly IPage _page;
private readonly ILocator _searchTermInput;

public SearchPage(IPage page)
_page = page;
_searchTermInput = page.Locator("[aria-label='Enter your search term']");

public async Task Goto()
await _page.GotoAsync("");

public async Task Search(string text)
await _searchTermInput.FillAsync(text);
await _searchTermInput.PressAsync("Enter");

Page objects can then be used inside a test.

using BigEcommerceApp.Tests.Models;

// in the test
var page = new SearchPage(await browser.NewPageAsync());
await page.Goto();
await page.Search("search query");

API reference