puppeteer/docs/api/puppeteer.page.hover.md
jrandolf f07ad2c661
fix: update documentation on configuring puppeteer ()
This PR updates the docs regarding configuring puppeteer. In addition,
some changes have been made to the documentation generator to show
default values on the documentation site.

Also fixes: https://github.com/puppeteer/puppeteer/pull/9144
2022-10-24 09:07:05 +02:00

32 lines
1.3 KiB
Markdown

---
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](./puppeteer.page.mouse.md) to hover over the center of the element. If there's no element matching `selector`, the method throws an error.
#### Signature:
```typescript
class Page {
hover(selector: string): Promise<void>;
}
```
## Parameters
| Parameter | Type | Description |
| --------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| selector | string | A [selector](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors) to search for element to hover. If there are multiple elements satisfying the selector, the first will be hovered. |
**Returns:**
Promise&lt;void&gt;
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)](./puppeteer.page.hover.md).