DocsElement Statebrowser_count_elements

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

123456789101112
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"
)

Parameters

Required

context_idstringrequired

The unique identifier of the browser context (e.g., 'ctx_000001')

selectorstringrequired

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>
}