Skip to content

scrollUntilTextIsVisible

Scroll until the target element is visible. Give one target: ‘text’ (substring), ‘textRegex’ (whole-text regex), or ‘id’.

Source

  • Kind: class-backed
  • Class: xyz.block.trailblaze.toolcalls.commands.ScrollUntilTextIsVisibleTrailblazeTool

Contract

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

Input schema

Optional parameters

  • text — String Text to scroll to (substring match).
  • textRegex — String Regex that must match the element’s whole text, e.g. ‘Loyalty’ won’t match ‘Loyalty Enroll’. Overrides ‘text’.
  • id — String Element id to scroll to.
  • index — Integer 0-based index when several elements match. Default 0.
  • direction — enum(UP | DOWN | RIGHT | LEFT) Scroll direction. Default DOWN.
  • visibilityPercentage — Integer Percent of the element that must be visible. Default 100.
  • centerElement — Boolean Keep scrolling until the element is near screen center, so bars or banners can’t intercept a tap. Omit for the driver default.
  • scrollStartPosition — enum(CENTER | TOP | BOTTOM) Screen region each swipe starts from. Default CENTER.
  • scrollDurationMs — Integer Duration of each swipe in ms; lower is faster. Omit for the driver default; lower it (e.g. 200) if swipes register as taps.
  • 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.