hover

Same target rules as click. Useful for revealing tooltips or hover-only menus.

Parameters

Parameter	Type	Required	Description
`on`	`string`	No	Natural-language description of the hover target.
`css`	`string`	No	CSS selector for the target. Use instead of the description key.
`coords`	`string \| { x, y }`	No	Absolute viewport coordinates. Either an `x, y` string (e.g. `120, 40`) or a `{ x, y }` object.
`x`	`number \| string`	No	X coordinate. Must be provided together with `y`.
`y`	`number \| string`	No	Y coordinate. Must be provided together with `x`.
`force`	`boolean`	No	Force the action even when the element is not actionable.
`iframe`	`string`	No	URL or URL pattern of the iframe that contains the target element.
`offset`	`string \| { x, y }`	No	Pixel offset from the resolved target. Either an `x, y` string or a `{ x, y }` object.
`saveAs`	`string`	No	Name of the variable to write this step’s return value to.
`retries`	`number`	No	Number of times to retry the step on failure before failing the test.
`skipped`	`boolean`	No	Skip this step at execution time.

Target description as a single string.

- hover: the card on the page containing "return 3"

- hover:
    css: '[aria-label="Stable hover card panel"]'
    offset:
      x: 489
      y: 69

- hover:
    coords: 5, 5