DocsScroll Controlbrowser_scroll_to_element

browser_scroll_to_element

Browser Scroll To Element

Scroll the page to bring a specific element into view. Uses smooth scrolling to center the element in the viewport. Target elements using CSS selector or natural language description.

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.scroll_to_element(
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 scroll into view. Examples: '#footer', '.product-reviews', 'the comments section'

Optional

indexstring

When multiple elements match the selector, scroll to the Nth element (0-based). Default: -1 (first match)

Response

Returns a JSON object with the operation result.

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