跳至主要內容
版本:23.11.1

ElementHandle.$() 方法

查詢目前元素中符合指定選擇器的元素。

簽名

class ElementHandle {
$<Selector extends string>(
selector: Selector,
): Promise<ElementHandle<NodeFor<Selector>> | null>;
}

參數

參數

類型

描述

selector

Selector

要查詢頁面的選擇器CSS 選擇器可以直接傳遞,而 Puppeteer 特定的選擇器語法允許通過文字a11y 角色和名稱以及 xpath 進行查詢,並跨陰影根結合這些查詢。或者,您可以使用前綴指定選擇器類型。

返回

Promise<ElementHandle<NodeFor<Selector>> | null>

符合指定選擇器的第一個元素的元素句柄。否則為 null