puppeteer/website/versioned_docs/version-21.5.0/api/puppeteer.page.hover.md
release-please[bot] b33ff31c2a
chore: release main (#11275)
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2023-11-02 16:51:26 +01:00

1.3 KiB

sidebar_label
Page.hover

Page.hover() method

This method fetches an element with selector, scrolls it into view if needed, and then uses Page.mouse to hover over the center of the element. If there's no element matching selector, the method throws an error.

Signature:

class Page {
  hover(selector: string): Promise<void>;
}

Parameters

Parameter Type Description
selector string A selector to search for element to hover. If there are multiple elements satisfying the selector, the first will be hovered.

Returns:

Promise<void>

Promise which resolves when the element matching selector is successfully hovered. Promise gets rejected if there's no element matching selector.

Remarks

Shortcut for page.mainFrame().hover(selector).