跳至主要內容
版本: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在 shadow roots 中組合這些查詢進行查詢。或者,您可以使用前綴指定選擇器類型。 如果有多個元素滿足 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]) 的快捷方式。