Built-in Locators in Playwright
From the Playwright cheat sheet · Locators · verified Jul 2026
Built-in Locators
Use role-based, text, and semantic locators to find elements
typescript
// By role (preferred — accessible and resilient)
page.getByRole('button', { name: 'Submit' })
page.getByRole('heading', { name: 'Welcome' })
page.getByRole('link', { name: 'Home' })
// By label, placeholder, text
page.getByLabel('Email')
page.getByPlaceholder('Search...')
page.getByText('Hello World')
// By test ID
page.getByTestId('submit-btn')💡 Prefer getByRole over CSS selectors — it mirrors how users and assistive tech see the page
⚡ Locators auto-wait and auto-retry — no need for explicit waitFor calls
📌 Use filter() to narrow down results from broad locators like getByRole("listitem")
🟢 getByTestId uses data-testid by default — customizable in playwright.config.ts
locatorsselectors