# browser_focus

## Browser Focus

Set focus to an element without clicking it. The element receives keyboard events and becomes the active element. Useful for preparing to type or when click would trigger unwanted actions.

## Usage Example

### Python SDK

```python
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.focus(
        context_id=context_id,
        selector="#element-id"
    )
```

### Node.js SDK

```javascript
import { OwlBrowser } from '@olib-ai/owl-browser-sdk';
// Async usage
const ctx = await browser.createContext();
const contextId = ctx.context_id;
await browser.focus({
    context_id: contextId,
    selector: '#element-id'
});
```

### CURL

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

## Parameters

### Required
- `context_id` string required
  - The unique identifier of the browser context (e.g., 'ctx_000001')
- `selector` string required
  - CSS selector or natural language description of the element to focus

### Optional
- `index` string
  - When multiple elements match the selector, target the Nth element (0-based). Default: -1 (first match)

## Response

Returns a JSON object with the operation result.

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