Mouse Click On Elements

The Mouse Click On Elements command (Command Type: 2) selects elements by CSS selector, calculates their position on screen, moves the mouse there, and clicks with configurable randomness to simulate human behavior.

Command Type

Command Type ID: 2

Parameters

Parameter	Type	Description	Required
selector	string	CSS selector to identify the element(s) to click	Yes
scrollable	boolean	If `true`, attempts to scroll the element into the viewport before clicking	Yes
spread	number	Randomness of mouse movement within the element (0–100)	Yes
timeout	number	Timeout for the command in milliseconds	Yes
filters	Filters	Optional criteria to refine element selection	No
selectorChangedOnClick	boolean	Whether the selector changes after clicking	No
viewportAreaPercentage	number	Portion of the viewport considered as the active area (0–100). Defaults to `100`	No

Filters Object

Field	Type	Description	Required
className	string	Filter elements by class name	No
includeInnerText	Array of string	Include only elements whose inner text contains these strings	No
excludeInnerText	Array of string	Exclude elements whose inner text contains these strings	No

Usage Examples

Click a Button

{
  "command": "mouse-click-on-elements",
  "params": {
    "selector": "button.accept",
    "scrollable": true,
    "spread": 20,
    "timeout": 10000
  }
}

Click with Inner Text Filter

{
  "command": "mouse-click-on-elements",
  "params": {
    "selector": ".menu-item",
    "scrollable": false,
    "spread": 10,
    "timeout": 5000,
    "filters": {
      "includeInnerText": ["Football"]
    }
  }
}

Common Use Cases

Human-Like Clicks: Simulate natural mouse movement and click to avoid detection
Conditional Clicks: Click only elements matching a specific text
Scrollable Targets: Click elements that are below the fold

Move Mouse - Move mouse before clicking
Click by Javascript - Programmatic JS click (no mouse simulation)

Quick Start

Commands Glossary

Mouse Click On Elements

Command Type

Parameters

Filters Object

Usage Examples

Click a Button

Click with Inner Text Filter

Common Use Cases

​Command Type

​Parameters

​Filters Object

​Usage Examples

​Click a Button

​Click with Inner Text Filter

​Common Use Cases

​Related Commands

Command Type

Parameters

Filters Object

Usage Examples

Click a Button

Click with Inner Text Filter

Common Use Cases

Related Commands