# browser_count_elements

## Browser Count Elements

Count the number of elements matching a CSS selector. Returns the count as an integer. Useful for checking how many items exist (e.g., list items, search results, table rows) without extracting full element data.

## Usage Example

### 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_count_elements
```

### 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.count_elements(
        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.countElements({
    context_id: contextId,
    selector: '#element-id'
});
```

## Parameters

### Required

- `context_id` **string required**  
  The unique identifier of the browser context (e.g., 'ctx_000001')  
- `selector` **string required**  
  CSS selector to count matching elements (e.g., 'li.item', 'input[type="text"]', 'table tr')

## Response

Returns a JSON object with the operation result.

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