What problem does it solve?
Provides a reproducible, developer-friendly way to run Playwright-driven tests and interactions against local web applications while managing server lifecycles and avoiding flaky timing issues.
Core Features & Use Cases
- Server Orchestration: scripts/with_server.py launches one or more local servers, waits for ports to be ready, runs a command, and reliably tears down processes.
- Playwright Automation Examples: examples show element discovery, static HTML automation, screenshot capture, and console log collection patterns.
- Reconnaissance-Then-Action Pattern: guidance to wait for networkidle, inspect rendered DOM, discover selectors, then execute deterministic actions for robust UI tests.
- Use Case: Run a frontend and backend locally, discover UI selectors from runtime DOM, capture screenshots and console logs, and validate frontend behavior in CI-like workflows.
Quick Start
Run the scripts/with_server.py helper with --help, start your local app(s), then run a Playwright script that navigates to the local URL, waits for networkidle, inspects the DOM, and captures screenshots and logs.