Click

Click an element using a snapshot ref, CSS selector, XPath selector, text selector, or semantic selector.

terminal 
pinchtab click e5
curl -X POST http://localhost:9867/action \  -H "Content-Type: application/json" \  -d '{"kind":"click","ref":"e5"}'
Response 
OK

CLI Flags

FlagDescription
--cssCSS selector instead of ref
--wait-navWait for navigation after click
--snapOutput interactive snapshot after click
--snap-diffOutput snapshot diff after click
--textOutput page text after click
--dialog-actionAuto-handle JS dialog: accept or dismiss
--dialog-textPrompt response text (with --dialog-action accept)
--x, --yClick at specific coordinates
--jsonFull JSON response
--tabTarget specific tab

Examples

terminal 
pinchtab click e5                       # Click by refpinchtab click "#login"                 # Click by CSSpinchtab click "text:Submit"            # Click by textpinchtab click e5 --snap                # Click and show new snapshotpinchtab click e5 --wait-nav            # Click and wait for navigationpinchtab click e5 --dialog-action accept  # Auto-accept alert/confirmpinchtab click --x 100 --y 200          # Click at coordinates
pinchtab click e5                       # Click by refpinchtab click "#login"                 # Click by CSSpinchtab click "text:Submit"            # Click by textpinchtab click e5 --snap                # Click and show new snapshotpinchtab click e5 --wait-nav            # Click and wait for navigationpinchtab click e5 --dialog-action accept  # Auto-accept alert/confirmpinchtab click --x 100 --y 200          # Click at coordinates

Notes

  • Element refs come from /snapshot
  • Refs for iframe descendants can be clicked directly without frame switch
  • Selector lookup is limited to current frame scope (default: main)
  • Use /frame before selector-based iframe actions
  • Missing selectors fail immediately; use pinchtab wait first for dynamic UI
  • The API also accepts selector field: {"kind":"click","selector":"#login"}