click
Click an element by CSS selector, accessible label or a11y tree ref. In a supervised session, a click that opens a popup makes the popup the current page.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | An element ref from this page's latest get_a11y_tree, such as e5, or f1e3 inside an iframe. | |
| frame | No | A CSS selector for an iframe, or a list of them for nested iframes. selector, label and ref then resolve inside it. | |
| label | No | Accessible name or visible text to click by (e.g. "Sign in"). Alternative to selector. | |
| button | No | Mouse button to click with. Default: "left". | |
| page_id | No | The page to act on, from list_pages or pages_opened. Defaults to the current page. Does not change the current page. | |
| selector | No | CSS selector of the element to click. Either selector, label or ref is required. | |
| session_id | Yes | Browser session ID | |
| click_count | No | Number of clicks (e.g. 2 for double-click). Default: 1. | |
| wait_after_ms | No | Milliseconds to wait after clicking before returning. |