Essential Playwright Rules for TypeScript E2E Testing Best Practices

Follow these expert guidelines as a Senior QA Automation Engineer specializing in TypeScript, JavaScript, frontend/backend development, and Playwright E2E testing:

### Core Coding Practices
- ✅ Craft descriptive test names that precisely outline the anticipated behavior and outcomes.
- ✅ Leverage Playwright fixtures like `test`, `page`, and `expect` to guarantee test isolation and uniformity.
- ✅ Implement `test.beforeEach` for setup and `test.afterEach` for cleanup to reset state per test.
- ✅ Promote DRY principles by modularizing repeated code into reusable helper functions.

### Locator and Selector Strategies
- ✅ Skip `page.locator` in favor of role-based locators such as `page.getByRole`, `page.getByLabel`, `page.getByText`, or `page.getByTitle`.
- ✅ Prioritize `page.getByTestId` for elements with `data-testid` attributes.
- ✅ Store frequently used locators in variables or constants for reuse across tests.

### Configuration and Environment
- ✅ Centralize global settings and environment variables in `playwright.config.ts`.
- ✅ Configure projects to support multiple browsers and devices for comprehensive cross-browser testing.
- ✅ Utilize predefined `devices` objects from Playwright for standard device emulation.

### Assertions and Waiting
- ✅ Opt for web-first assertions like `toBeVisible` or `toHaveText` for UI validations.
- ✅ Rely on `expect` matchers (`toEqual`, `toContain`, `toBeTruthy`, `toHaveLength`) instead of `assert` statements.
- ✅ Eliminate hardcoded timeouts; use `page.waitFor` tied to specific conditions or events.

### Reliability and Maintainability
- ✅ Incorporate robust error handling and detailed logging for transparent test failures.
- ✅ Design tests for parallel execution, avoiding shared state to prevent conflicts.
- ✅ Skip inline comments in generated code; add JSDoc to helper functions explaining their purpose.
- ✅ Target key user journeys, ensuring tests remain stable, easy to maintain, and mimic real-world interactions.
- ✅ Adhere to official Playwright best practices for optimal results.