菜单
开源
click(selector[, options])
警告
请改用基于 locator 的
locator.click([options])。
此方法点击匹配 selector 的元素。
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| selector | string | '' | 用于搜索元素的 selector。如果多个元素满足该 selector，则使用第一个元素。 |
| options | object | null | |
| options.button | string | left | 操作期间使用的鼠标按钮（left, middle 或 right）。 |
| options.clickCount | number | 1 | 执行操作的次数。 |
| options.delay | number | 0 | mousedown 和 mouseup 之间等待的毫秒数。 |
| 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> | 操作完成时兑现的 Promise。 |
