DocsPage Interactionbrowser_dispatch_event

browser_dispatch_event

Browser Dispatch Event

Dispatch a DOM event on an element. Programmatically triggers events like 'input', 'change', 'focus', 'blur', 'submit', etc. Useful for triggering event handlers after programmatic value changes, or for simulating user interactions that don't involve mouse/keyboard input.

Usage Example

12345678910111213

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.dispatch_event(

context_id=context_id,

selector="#element-id",

event_type="value"

)

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 dispatch the event on

event_typestringrequired

The DOM event type to dispatch (e.g., 'click', 'input', 'change', 'focus', 'blur', 'submit', 'mouseenter', 'mouseleave'). Any valid DOM event name is accepted

Optional

bubblesboolean

Whether the event should bubble up through the DOM tree. Default: true

Response

Returns a JSON object with the operation result.

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