What problem does it solve?
Local web applications are often hard to test reliably because they require coordinating one or more local servers, waiting for dynamic JavaScript to finish rendering, discovering stable selectors, and capturing browser state for debugging and verification.
Core Features & Use Cases
- Server orchestration: Helper script scripts/with_server.py starts one or more local servers, waits for readiness on specified ports, runs a given command, and then cleans up processes.
- Reconnaissance-then-action testing: Use Playwright-based Python scripts to wait for networkidle, inspect rendered DOM, discover selectors, and then perform deterministic interactions.
- Debugging and artifacts: Capture full-page screenshots, save console logs, and record element discovery output to aid debugging.
- Use Case: Run a frontend and backend together, wait for both to be ready, discover selectors from the rendered page, and execute automated UI checks while saving screenshots and console output for CI diagnostics.
Quick Start
Start the servers with the helper and run a Playwright automation script that navigates to the local app, waits for network idle, captures a screenshot, and collects console logs.