DocsElement Statebrowser_get_bounding_box

browser_get_bounding_box

Browser Get Bounding Box

Get the position and size of an element. Returns {x, y, width, height} representing the element's bounding rectangle in viewport coordinates. Useful for positioning or calculating drag coordinates.

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.get_bounding_box(
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 or natural language description of the element to get position and size for

Optional

indexstring

When multiple elements match the selector, get bounding box of the Nth element (0-based). Default: -1 (first match)

Response

Returns a JSON object with the operation result.

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