Fill

Set an input value directly without relying on the same event sequence as type.

terminal 
pinchtab fill e8 "ada@pinchtab.com"
curl -X POST http://localhost:9867/action \  -H "Content-Type: application/json" \  -d '{"kind":"fill","ref":"e8","text":"ada@pinchtab.com"}'
Response 
OK

CLI Flags

FlagDescription
--snapOutput interactive snapshot after fill
--snap-diffOutput snapshot diff after fill
--textOutput page text after fill
--jsonFull JSON response
--tabTarget specific tab

Examples

terminal 
pinchtab fill e8 "ada@pinchtab.com"     # Fill by refpinchtab fill "#email" "user@example.com"  # Fill by CSSpinchtab fill "text:Email" "test@test.com" # Fill by text selectorpinchtab fill e8 "value" --snap         # Fill and show snapshot
pinchtab fill e8 "ada@pinchtab.com"     # Fill by refpinchtab fill "#email" "user@example.com"  # Fill by CSSpinchtab fill "text:Email" "test@test.com" # Fill by text selectorpinchtab fill e8 "value" --snap         # Fill and show snapshot

Notes

  • Accepts unified selectors: e8, #email, xpath://..., text:Email
  • Refs for iframe descendants can be filled directly without frame switch
  • Selector lookup is limited to current frame scope (default: main)
  • Use /frame before selector-based iframe fills
  • Missing selectors fail immediately; use pinchtab wait first for async fields
  • For API, use selector field for CSS/XPath/text selectors