Skip to main content
Same target rules as click. Useful for revealing tooltips or hover-only menus.

Parameters

ParameterTypeRequiredDescription
onstringNoNatural-language description of the hover target.
cssstringNoCSS selector for the target. Use instead of the description key.
coordsstring | { x, y }NoAbsolute viewport coordinates. Either an x, y string (e.g. 120, 40) or a { x, y } object.
xnumber | stringNoX coordinate. Must be provided together with y.
ynumber | stringNoY coordinate. Must be provided together with x.
forcebooleanNoForce the action even when the element is not actionable.
iframestringNoURL or URL pattern of the iframe that contains the target element.
offsetstring | { x, y }NoPixel offset from the resolved target. Either an x, y string or a { x, y } object.
saveAsstringNoName of the variable to write this step’s return value to.
retriesnumberNoNumber of times to retry the step on failure before failing the test.
skippedbooleanNoSkip this step at execution time.

Shorthand

Target description as a single string.
- hover: the card on the page containing "return 3"

Examples

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