Skip to content

High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.

1.4 KB
Raw Blame

Select

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

curl -X POST http://localhost:9867/action \
  -H "Content-Type: application/json" \
  -d '{"kind":"select","ref":"e12","value":"it"}'
# CLI Alternative
pinchtab select e12 it
# Response (use --json for full JSON)
OK

CLI Flags

Flag Description
--snap Output snapshot after select
--snap-diff Output snapshot diff after select
--text Output page text after select
--json Full JSON response
--tab Target 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:

pinchtab select e12 uk
pinchtab 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.

The API reads value, falling back to text. When nothing matches, the action answers 422 option_not_found; details.available lists the options as {value, text} and details.hint renders them.

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

Related Pages