跳至主要內容
版本:23.11.1

Page.focus() 方法

此方法會使用 selector 獲取一個元素並使其獲得焦點。如果沒有元素符合 selector,該方法會拋出錯誤。

簽名

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

參數

參數

類型

描述

selector

字串

要查詢頁面的選擇器。可以原樣傳遞 CSS 選擇器,而 Puppeteer 特定的選擇器語法允許通過 文字a11y 角色和名稱以及 xpath跨陰影根組合這些查詢來查詢。或者,您可以使用前綴指定選擇器類型。如果有多個元素滿足選擇器,則第一個元素將被聚焦。

回傳

Promise<void>

當成功聚焦符合選擇器的元素時,會解析 Promise。如果沒有元素符合選擇器,Promise 將被拒絕。

備註

page.mainFrame().focus(selector) 的捷徑。