What problem does it solve?
Provides a disciplined, repeatable approach to automating browser interactions and verifying web UI behavior so tests are deterministic, token-efficient, and resilient to flaky DOM changes.
Core Features & Use Cases
- Tab & Session Management: Open and track tabs within the user's existing browser session and avoid reusing stale tab IDs.
- Snapshot-First Interactions: Capture page structure and ephemeral element references before every action to prevent stale-element errors.
- Element Interaction & Forms: Robust element clicks, typed input, fill_form for multi-field submissions, and scroll-into-view handling for nested containers.
- Observability: Targeted console log filtering, network request inspection, and selective screenshots (element-scoped or full-page) for evidence.
- Failure Escalation & Verification: Short incremental waits, 2-3 retry limits, clear escalation when elements or navigation fail, and a PASS/FAIL verification workflow for frontend changes.
- Use Case: Validate a new feature on a staging site by starting the dev server, navigating to the page, exercising form flows, checking console and network, and producing screenshots and a structured verdict.
Quick Start
Open the application's page in a new browser tab, snapshot the DOM, perform the intended interactions, capture console and network errors, and collect screenshots to report pass or fail.
