getByText

Introduction

getByText is a practical Playwright skill for anyone tired of fragile selectors and DOM-dependent automation. Instead of memorizing syntax, learn the production reason behind it: what risk it reduces, what evidence it gives, and how it changes the way a team ships software.

Purpose of this lesson

Story: A team had one unstable CSS selector in checkout. It failed only in CI and blocked three releases. Playwright locators by role and label turned the test from DOM-dependent to user-intent-driven. In this lesson, getByText is useful for visible text but needs careful uniqueness. That is the difference between a test that merely runs and a test that helps a team decide.

Understanding the topic

Why this exists: getByText is useful for visible text but needs careful uniqueness. A locator should describe what a user understands, not how a developer happened to arrange divs today.

• Real problem solved: getByText reduces ambiguity when browser behavior, data, timing, or infrastructure changes.
• Production use: all UI tests, component tests, page objects, assertions, accessibility checks, and code reviews.
• Beginner misuse: Copying long CSS/XPath from DevTools and never asking whether the user-facing name is more stable.
• Elite SDET move: Prefer role, label, text, and test id contracts. Treat locator design as part of application quality.

Visual explanation

Mental model:

Best
  getByRole / getByLabel
  ↓
Good
  getByTestId
  ↓
Fallback
  CSS
  ↓
Last resort
  XPath

Informative example

A practical example for getByText:

await page.goto("/getbytext");
await page.getByRole("button", { name: "Add to cart" }).click();
await expect(page.getByRole("status")).toHaveText(/added/i);

// Good fallback for custom widgets:
await page.getByTestId("cart-total").toContainText("
quot;);

Execution workflow

Real-world use

In real teams, getByText matters because product code changes every week. The test must still tell a useful story: what user behavior was protected, what state was expected, what evidence was captured, and whether the failure belongs to the app, the test, the data, or the environment.

Best practices

• Start with accessible locators: role, label, text, placeholder.
• Use test ids as explicit contracts for complex components.
• Chain locators to express scope, not to mirror the full DOM.
• Review locator changes like production code.

Common mistakes

• Using positional selectors for business-critical flows.
• Using text locators for translated or frequently changing copy.
• Hiding accessibility problems by relying only on test ids.

Debugging tips

• Use Playwright Inspector to test locator uniqueness.
• Check strict mode errors: they usually mean your locator is ambiguous.
• Inspect accessible names when getByRole does not find the expected element.

Advanced interview questions

Summary

getByText is valuable when it makes browser automation faster, clearer, and easier to debug under real product change.