browser_expand
Browser Expand
Re-serialize one collapsed region, dedup template, or handle at higher detail. Use after browser_observe when a region was folded for the token budget. Requires render_mode 'agent' or 'both'.
Usage Example
1234567891011
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.expand(
context_id=context_id
)
Parameters
Required
context_idstringrequiredThe unique identifier of the browser context (e.g., 'ctx_000001')
Optional
handlestringThe handle token of the collapsed region/template to expand (from a prior browser_observe). Accepts a template id like 'T1' or any handle token. Either 'handle' or 'selector' is required.
selectorstringAlias for 'handle': the same OwlMark handle token that click/type accept. Use either 'handle' or 'selector'.
detailenumminnormalfullDetail level for the expanded region
Response
Returns a JSON object with the operation result.
{
"success": true,
"result": <value>
}