Playwright Best Practices

Expert guidance for writing reliable, maintainable Playwright tests.

Quick Reference

Concern	Best Practice	Avoid
Selectors	getByRole, getByTestId, getByLabel	CSS classes, DOM structure
Waits	Auto-waiting, explicit assertions	waitForTimeout, hardcoded delays
Accessibility	getByRole, a11y checks	Visual-only testing
Flaky tests	Proper waits, stable selectors	Timing-dependent assertions
Isolation	Cleanup after each test	Tests depending on each other
Parallel	Independent tests	Shared state