test-forge

Playwright E2E tests in TypeScript use built-in locators like getByRole, getByLabel, and getByText with web assertions that auto-wait for actionability. Use fixtures to isolate setup and Page Object Models for large suites to keep selectors maintainable.

Debug flaky Playwright tests systematically using UI Mode for time-travel inspection, Trace Viewer for CI-only failures, and targeted console breadcrumbs with a flow, step, and request id. Replace sleep-based timeouts with explicit web assertions to remove nondeterminism.

Vitest unit tests cover pure logic like parsing, formatting, and validators using AAA structure and fake timers. Integration tests validate contracts across boundaries such as API handlers and database adapters, checking error mapping, retries, and idempotency with real dependencies where feasible.

Use Vitest for unit and integration tests of TypeScript logic, API handlers, and multi-module flows. Use Playwright Test for end-to-end coverage of 1-3 critical user journeys per feature where real browser behavior matters.

Flakiness usually comes from sleep-based timeouts, brittle CSS selectors, shared state, or nondeterministic data. Fix it by using auto-waiting locators, test fixtures for isolation, stable test data, and retries only as a last resort rather than to hide real issues.