跳至主要內容
版本:23.11.1

Page.hover() 方法

這個方法會取得具有 selector 的元素,如果需要,會將它滾動到可見範圍,然後使用 Page.mouse 將游標懸停在元素的中心。如果沒有符合 selector 的元素,此方法會拋出錯誤。

簽名

class Page {
hover(selector: string): Promise<void>;
}

參數

參數

類型

描述

selector

字串

要查詢頁面的選擇器CSS 選擇器可以直接傳遞,而 Puppeteer 特定的選擇器語法允許依文字a11y 角色和名稱以及 xpath 進行查詢,並且 在 shadow root 中組合這些查詢。或者,您可以使用 前綴 來指定選擇器類型。如果有符合 selector 的多個元素,則會懸停在第一個元素上。

回傳

Promise<void>

當成功懸停符合 selector 的元素時解析的 Promise。如果沒有符合 selector 的元素,則 Promise 會被拒絕。

備註

page.mainFrame().hover(selector) 的快捷方式。