Playwright Best Practices

Use When

• Writing new Playwright tests
• Reviewing Playwright test changes
• Fixing flaky Playwright tests
• Choosing locators, assertions, fixtures, projects, or debug settings
• Refactoring Playwright tests toward user-visible behavior

Do Not Use When

• Testing non-browser unit logic better covered by unit tests
• Writing tests for third-party sites or services you do not control
• Adding sleeps, retries, or larger timeouts to hide nondeterministic behavior
• Building Page Object Models before duplication or intent problems exist

Workflow