Page & Element Assertions in Playwright

From the Playwright cheat sheet · Assertions · verified Jul 2026

Page & Element Assertions

Assert on page state, element visibility, text content, and attributes

typescript

// Page assertions
await expect(page).toHaveTitle(/Dashboard/);
await expect(page).toHaveURL('/dashboard');

// Visibility
await expect(page.getByText('Welcome')).toBeVisible();
await expect(page.getByText('Loading')).toBeHidden();

// Text content
await expect(page.locator('h1')).toHaveText('Hello');
await expect(page.locator('p')).toContainText('world');

💡 All expect assertions auto-retry until the condition is met or timeout expires

⚡ Use soft assertions when you want to collect all failures without stopping the test

📌 Screenshot assertions auto-generate golden files on first run — commit them to git

🟢 Default assertion timeout is 5s — override per-assertion with { timeout: ms }

assertionsexpect

Back to the full Playwright cheat sheet