Screenshot
screenshotRead-onlyIdempotent
Capture a tab's viewport, entire page, or a specific element as an image via the DevTools engine, without bringing the tab to the foreground.
Instructions
Take a screenshot of a tab and return it as an image: the viewport, the whole page (full_page), or one element (selector). Needs the DevTools engine (see cdp_status). Works on a background tab without bringing it forward; pass activate true only if you want Arc to show it (that waits for the user to pause, like open_url, and restores their focus afterwards). A full page is capped at 16384 px tall and the result says when it was cut. Prefer jpeg with a quality for a long page, since a large PNG is a lot of tokens.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nth | No | Which match to capture when several exist, 0-based | |
| exact | No | For "text=", "label=" and "placeholder=" selectors, require the whole trimmed text to equal the label. No effect on CSS, ref= or role= selectors. | |
| format | No | Image format | png |
| tab_id | No | Arc tab id from list_tabs. Omit to use the tab you opened last. Unlike other read tools this never falls back to the tab the user is looking at: with no id and no tab of yours it is refused, so pass this or call open_url first. | |
| quality | No | JPEG quality, 1-100. Ignored for png. | |
| activate | No | Bring the tab to the front first. This changes what the user sees, so leave it off unless needed. It waits until the user has stopped typing, fails with userActive true if they never pause, and puts their window and application back in front afterwards (focusRestored says whether that worked). | |
| selector | No | Capture just this element instead of the viewport. CSS selector, "text=Label", or ref=, role=, label=, placeholder= as in click. | |
| full_page | No | Capture the whole scrollable page, not just the viewport. Not combinable with selector. | |
| timeout_ms | No | Give up on the capture after this long. Capped at 30000ms so the call cannot outlive a client's request timeout. To wait longer, call this again. |