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

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

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

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.

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