11.1Overview

A note on how to read the examples: the Playwright CLI is ref-driven. The agent takes a snapshot (a YAML accessibility summary saved to disk), reads it to find elements like textbox "Email" [ref=e3], and then acts by ref. In the examples below, assume refs come from the most recent snapshot — the comments show what the agent saw there. Every action auto-waits for actionability (same Playwright engine underneath), so you will see far fewer explicit waits than in 2025-era CLI scripts.