browser_pick

Browser Pick

Select an option from a dropdown or select element. Works with native HTML select elements and dynamic/custom dropdowns (like select2, react-select). Specify the option by its value or visible text. Automatically handles opening the dropdown and selecting the option.

Usage Example

Python SDK

POST `/api/execute/browser_pick`
curl -X POST \
 -H "Authorization: Bearer <token>" \
 -H "Content-Type: application/json" \
 -d '{
"context_id": "ctx_000001",
"selector": "#element-id",
"value": "<value>"
}' \
http://localhost:8080/api/execute/browser_pick

Node.js SDK

import asyncio

from owl_browser import OwlBrowser, RemoteConfig

# Async usage
async with OwlBrowser(config) as browser:
    context = await browser.create_context()
    context_id = context["context_id"]
    await browser.pick(
        context_id=context_id,
        selector="#element-id",
        value="value"
    )

CURL

import { OwlBrowser } from '@olib-ai/owl-browser-sdk';

// Async usage
const ctx = await browser.createContext();
const contextId = ctx.context_id;
await browser.pick({
    context_id: contextId,
    selector: '#element-id',
    value: 'value'
});

Parameters

Required

  • context_id string required
    The unique identifier of the browser context (e.g., 'ctx_000001')
  • selector string required
    Target dropdown/select element. Accepts CSS selector (e.g., '#country', 'select[name="size"]') or natural language description (e.g., 'country dropdown', 'size selector')
  • value string required
    The option to select. Can be the option's value attribute OR the visible display text. Works with both native select elements and dynamic dropdowns (select2, etc.)

Response

Returns a JSON object with the operation result.

{
  "success": true,
  "result": <value>
}