1.2 KiB
Screenshots
This is lookup-only guidance. Do not use it for ordinary navigation, reading, search, or form interaction when a DOM snapshot answers the question.
Capture a screenshot only when the user explicitly requests one, visual layout/rendering/image content must be judged, or the required target is absent from the DOM snapshot. Do not request a snapshot and screenshot together by default.
await tab.screenshot(opts?) returns PNG bytes as Uint8Array internally. Those bytes are not a model-visible screenshot and must never be returned as the JS result.
Every screenshot call must pass the bytes to nodeRepl.emitImage in the same JS cell so the tool returns a standard image content block:
nodeRepl.emitImage(await tab.screenshot());
Never use await tab.screenshot() as the final expression.
Supported screenshot options:
{ fullPage: true }captures the whole page.{ clip: { x, y, width, height } }captures a viewport region.
If a screenshot times out, do not immediately issue the same screenshot again. The underlying Chromium capture may still be completing; wait before retrying, or reopen the tab if the explicit in-flight error does not clear.