Scroll

Scroll the current tab or a specific element.

terminal 
curl -X POST http://localhost:9867/action \  -H "Content-Type: application/json" \  -d '{"kind":"scroll","scrollY":800}'# Response: {"success":true,"result":{"success":true}}
Response 
# CLI Alternative (human-readable by default)
pinchtab scroll down
# Output: OK

pinchtab scroll down --snap        # scroll and output snapshot
pinchtab scroll 800 --snap-diff    # scroll and output snapshot diff
pinchtab scroll 800 --json         # Full JSON response

Notes:

  • use --snap to output an interactive snapshot after scrolling
  • use --snap-diff to output only the changes from the previous snapshot
  • the top-level CLI also accepts a pixel value such as pinchtab scroll 800
  • the raw API uses scrollY and scrollX for page scrolling
  • the raw API can also target an element with ref or selector
  • selector lookup is limited to the current frame scope; the default scope is main
  • use /frame or pinchtab frame before selector-based iframe scrolling