Skip to content

hover()

Fetches an element with the given selector, scrolls it into view if needed, and then hovers over the center of the element. If there’s no element matching selector, the method throws an error.

await hover('Get Started')
await hover(link('Get Started'))
await hover(link('Get Started'), { waitForEvents: ['firstMeaningfulPaint'], force: true })
NameTypeDescription
selectorselector | stringA selector to search for element to right click. If there are multiple elements satisfying the selector, the first will be hovered.
optionsObjectDefault: {}.
options.forcebooleanSet to true to perform action on hidden/disabled elements. Default: false.
options.waitForEventsArrayEvents available to wait for [‘DOMContentLoaded’, ‘loadEventFired’, ‘networkAlmostIdle’, ‘networkIdle’, ‘firstPaint’, ‘firstContentfulPaint’, ‘firstMeaningfulPaint’, ‘targetNavigated’] Default: [].

This API does not return any values.