Interaction Commands

click

Click an element on the page.

Parameter	Type	Required	Default	Description
selector	string	✅	—	Element selector (css=, xpath=, text=)
button	string	❌	left	Mouse button: left, right, middle
click_count	number	❌	1	Number of clicks (2 for double-click)
force	boolean	❌	false	Force click even if element is obscured
iframe	string	❌	—	Selector for iframe containing the element
position	object	❌	—	Click position relative to element: {x, y}
modifiers	array	❌	—	Keyboard modifiers: ["Control", "Shift"]
timeout	number	❌	5000	Max wait time in milliseconds

fill

Fill an input field with text.

Parameter	Type	Required	Default	Description
selector	string	✅	—	Input element selector
value	string	✅	—	Text to fill. Supports ${variable}.
clear_before_fill	boolean	❌	true	Clear existing text before filling
iframe	string	❌	—	Iframe selector
timeout	number	❌	5000	Max wait time

type

Type text character by character (simulates real keystrokes).

Parameter	Type	Required	Default	Description
selector	string	✅	—	Input element selector
text	string	✅	—	Text to type
delay	number	❌	0	Delay between keystrokes (ms)
clear	boolean	❌	false	Clear field before typing
iframe	string	❌	—	Iframe selector
timeout	number	❌	5000	Max wait time

press

Press a keyboard key on an element.

Parameter	Type	Required	Default	Description
selector	string	✅	—	Element selector
key	string	✅	—	Key to press (e.g., Enter, Tab, Escape, ArrowDown)
iframe	string	❌	—	Iframe selector
timeout	number	❌	5000	Max wait time

keyboard

Simulate a keyboard action (similar to press but with delay support).

Parameter	Type	Required	Default	Description
selector	string	✅	—	Element selector
key	string	✅	—	Key to press
delay	number	❌	0	Delay before key press (ms)
iframe	string	❌	—	Iframe selector
timeout	number	❌	5000	Max wait time

check / uncheck

Check or uncheck a checkbox or radio button.

Parameter	Type	Required	Description
selector	string	✅	Checkbox/radio selector
iframe	string	❌	Iframe selector
timeout	number	❌	Max wait time

select_option

Select an option in a dropdown (<select>) element.

Parameter	Type	Required	Description
selector	string	✅	Select element selector
value	string	✅	Value of the option to select
iframe	string	❌	Iframe selector
timeout	number	❌	Max wait time

hover

Hover the mouse over an element.

Parameter	Type	Required	Description
selector	string	✅	Element selector
iframe	string	❌	Iframe selector
timeout	number	❌	Max wait time

focus

Focus an element (gives it keyboard focus).

Parameter	Type	Required	Description
selector	string	✅	Element selector
iframe	string	❌	Iframe selector
timeout	number	❌	Max wait time

scroll

Scroll the page or a specific element.

Parameter	Type	Required	Default	Description
selector	string	❌	—	Element to scroll (omit for window scroll)
direction	string	❌	bottom	Direction: bottom, top, by_pixels
amount	number	❌	0	Pixels to scroll (for by_pixels)
smooth	boolean	❌	false	Smooth scrolling animation
delay	number	❌	1000	Delay after scroll (ms)
repeats	number	❌	1	Number of scroll repetitions
iframe	string	❌	—	Iframe selector

scroll_into_view

Scroll until a specific element is visible.

Parameter	Type	Required	Description
selector	string	✅	Element selector
iframe	string	❌	Iframe selector
timeout	number	❌	Max wait time

drag_to

Drag an element from source to target.

Parameter	Type	Required	Description
source_selector	string	✅	Source element selector
target_selector	string	✅	Target element selector
source_position	object	❌	Drag start position: {x, y}
target_position	object	❌	Drop position: {x, y}
iframe	string	❌	Iframe selector
timeout	number	❌	Max wait time

select_text

Select the text content of an element.

Parameter	Type	Required	Description
selector	string	✅	Element selector
iframe	string	❌	Iframe selector
timeout	number	❌	Max wait time

set_input_files

Set files for a file input element.

Parameter	Type	Required	Description
selector	string	✅	File input selector
paths	string	✅	File path(s) to select
iframe	string	❌	Iframe selector
timeout	number	❌	Max wait time

dispatch_event

Trigger a custom DOM event on an element.

Parameter	Type	Required	Description
selector	string	✅	Element selector
event_type	string	✅	Event name (e.g., mouseover, change, focus)
iframe	string	❌	Iframe selector
timeout	number	❌	Max wait time