Select

Choose an option in a native <select> element by selector or ref.

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

CLI Flags

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

Option Matching

Matching is forgiving. PinchTab tries these strategies in order:

  1. exact <option value="...">
  2. exact visible text
  3. case-insensitive visible text
  4. case-insensitive substring of visible text

All of these can work depending on the page:

terminal
pinchtab select e12 ukpinchtab select e12 "United Kingdom"pinchtab select e12 "united kingdom"pinchtab select e12 "Kingdom"
pinchtab select e12 ukpinchtab select e12 "United Kingdom"pinchtab select e12 "united kingdom"pinchtab select e12 "Kingdom"

Prefer the canonical option value or full visible text when disambiguation matters.

Selector lookup is limited to current frame scope (default: main). Use /frame before iframe selects.