playwright-click
Clicks one element of an open browser session and returns the screen the click led to.
A site-side refusal - a stale ref, an element something else covers - comes back in the error field instead of failing the query, and it says what to try instead. Read it and act differently; the same click will be refused the same way.
The screen after the click is in this row's observation field, with fresh refs, so the next action needs no observe of its own.
A read-only session allows this only for links, since following one is how it reaches the pages it may read.
playwright-click session-id=VALUE ref=VALUE [screenshot=VALUE]
- session-id=VALUE
- Required. Browser session to click in. e.g. the session_id returned by playwright-open
- ref=VALUE
- Required. Element to click, named by a ref from the last observation. Every reading reassigns refs, so take it from the most recent one. e.g. e45
- screenshot=VALUE
- Optional. Store a screenshot of the resulting screen. t by default. e.g. f
Output Fields
| Field | Type | Name | Description |
|---|---|---|---|
| session_id | String | Session id | e.g. 6f1c2a08-6c1e-4a1b-9a5e-9b2f0d3c7e11 |
| ref | String | Element ref | e.g. e45 |
| target | String | Target element | Snapshot line of the element acted on. e.g. - button "Save" [ref=e45] |
| result | String | Result | What the server reported for the action. e.g. Ran Playwright code |
| error | String | Error | Set when the site refused the action, so the row arrives instead of the query failing. e.g. click blocked: another element covers this one |
| url | String | URL after action | e.g. https://fw.example.com/policy/edit?id=12 |
| title | String | Page title after action | e.g. Edit policy - Firewall Console |
| element_count | Integer | Element count | Addressable elements on the screen the action landed on. e.g. 108 |
| screenshot_guid | String | Screenshot file guid | e.g. 3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f |
| screenshot_url | String | Screenshot URL | Served inline, so an answer can embed it as . e.g. /files/3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f |
| sonar_url | String | File store URL | Readable by sonar-ai-ask-image. e.g. sonar://3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f |
| observation | String | Observation | Accessibility snapshot of the screen after the action, with fresh refs - act on one of these rather than observing again. e.g. - button "Save" [ref=e45] |