For AI agents: a documentation index is available at /llms.txt
Skip to main content

hover

Waits for the element to be visible, scrolls to it, then hover on it with native events

**Usage Example:**

mutation HoverElement {
goto(url: "https://example.com") {
status
}

hover(selector: "a") {
time
}
}

**Field Definition:**

hover(
scroll: Boolean = true
selector: String
timeout: Float
visible: Boolean = false
wait: Boolean = true
x: Float
y: Float
): HoverResponse

Arguments​

hover.scroll ● Boolean scalar​

Whether or not to scroll to the element, defaults to true

hover.selector ● String scalar​

The CSS selector of the element on the page you want to hover on

hover.timeout ● Float scalar​

How long to wait for the element to appear before timing out, overriding any defaults. Default timeout is 30 seconds, or 30000.

hover.visible ● Boolean scalar​

Whether or not to hover on the element only if it's visible

hover.wait ● Boolean scalar​

Whether or not to wait for the element to present in the DOM

hover.x ● Float scalar​

The X coordinate, in pixels, to hover on the page

hover.y ● Float scalar​

The Y coordinate, in pixels, to hover on the page

Type​

HoverResponse object​

Response returned after having hovered over an element

Was this page helpful?