e2e-debugging-workflow

What problem does it solve?

This Skill provides a structured workflow to efficiently debug failing Playwright End-to-End (E2E) tests locally, reducing time spent in CI and improving test reliability.

Core Features & Use Cases

• Local Test Execution: Run specific E2E tests with debugging flags (--debug, --headed, --trace on).
• Environment Setup: Guides through starting the necessary local development environment (Docker, Payload CMS).
• Failure Analysis: Offers common failure patterns (selector timeouts, date picker issues, PHP page verification) with specific debugging steps and fixes.
• Use Case: When a Playwright E2E test fails in CI, use this Skill to replicate the failure locally, identify the root cause (e.g., a flaky selector), fix it, and verify the solution before committing.

Quick Start

To debug a failing E2E test, start your local environment, seed data, and then run the specific test file using yarn playwright test path/to/your/test.spec.ts --debug.