菜单
开源
hover(selector[, options])
警告
请改用基于 locator 的
locator.hover([options])。
此方法将鼠标悬停在匹配 selector 的元素上。
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| selector | string | '' | 用于搜索元素的 selector。如果存在多个匹配 selector 的元素，将使用第一个。 |
| options | object | null | |
| options.force | boolean | false | 将其设置为 true 将绕过可操作性检查 (visible, stable, enabled)。 |
| options.modifiers | string[] | null | 执行操作时按下的 Alt、Control、Meta 或 Shift 修饰键。如果未指定，则使用当前按下的修饰键。 |
| options.noWaitAfter | boolean | false | 如果设置为 true 且此操作导致导航发生，则不会等待其完成。 |
| options.position | object | null | 相对于元素左上角的点坐标。如果未提供，则使用元素的可见点。 |
| options.position.x | number | 0 | x 坐标。 |
| options.position.y | number | 0 | y 坐标。 |
| options.strict | boolean | false | 当为 true 时，调用要求 selector 只匹配一个元素。如果给定的 selector 匹配多个元素，则调用会抛出异常。 |
| options.timeout | number | 30000 | 最大超时时间（毫秒）。传递 0 以禁用超时。默认值将被 BrowserContext 或 Page 上的 setDefaultTimeout 选项覆盖。 |
| options.trial | boolean | false | 将其设置为 true 将执行可操作性检查，但不执行实际操作。 |
返回值
| 类型 | 描述 |
|---|---|
Promise<void> | 当 hover 操作完成时，此 Promise 会被 fulfill。 |
