跳到主要内容
版本: 23.11.1

Page.click() 方法

此方法会获取带有 selector 的元素,如果需要,会将其滚动到视图中,然后使用 Page.mouse 点击元素的中心。如果没有元素与 selector 匹配,该方法将抛出错误。

签名

class Page {
click(selector: string, options?: Readonly<ClickOptions>): Promise<void>;
}

参数

参数

类型

描述

selector

string

用于查询页面的 选择器CSS 选择器可以直接传递,并且 Puppeteer 特定的选择器语法允许通过 文本a11y 角色和名称以及 xpath 进行查询,并在阴影根之间组合这些查询。或者,您可以使用前缀指定选择器类型。如果存在多个满足 selector 的元素,则将单击第一个元素

options

Readonly<ClickOptions>

(可选) Object

返回

Promise<void>

当成功点击与 selector 匹配的元素时,Promise 将会解决。如果没有元素与 selector 匹配,则 Promise 将会被拒绝。

备注

请记住,如果 click() 触发了导航事件,并且有一个单独的 page.waitForNavigation() promise 要解析,您最终可能会遇到产生意外结果的竞争条件。点击并等待导航的正确模式如下:

const [response] = await Promise.all([
page.waitForNavigation(waitOptions),
page.click(selector, clickOptions),
]);

page.mainFrame().click(selector[, options]) 的快捷方式。