Skip to content

web_scroll

Scroll the page or a specific container in the specified direction. When ref is provided, scrolls within that container (e.g., a sidebar or panel) by moving the mouse to its center first. When ref is omitted, scrolls the full page.

Source

  • Kind: class-backed
  • Class: xyz.block.trailblaze.playwright.tools.PlaywrightNativeScrollTool

Contract

  • Visible to LLM: yes (surface_to_llm: true)
  • Recordable: yes (is_recordable: true)
  • Host-only: no (requires_host: false)

Input schema

Optional parameters

  • direction — ToolParameterType.Enum( entries = [UP, DOWN, LEFT, RIGHT] ) Direction to scroll. UP/DOWN for vertical, LEFT/RIGHT for horizontal.
  • amount — Integer Number of pixels to scroll. Defaults to 500.
  • ref — String Element reference for the container to scroll within: ARIA descriptor (e.g., ‘navigation “Sidebar”’), element ID (e.g., ‘e5’), or CSS selector with css= prefix (e.g., ‘css=#scrollable-panel’). When omitted, scrolls the full page.
  • reasoning — String

Output

Returns: string (opaque text content)

Typed result schemas (kind: query | action, MCP structuredContent) are not yet carried by the resolved manifest — this section will gain detail when that lands.