Puppeteer 中文文档v25.8.0

Frame.$() 方法

在框架中查询与给定选择器匹配的元素。

签名

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

参数

参数

类型

说明

selector

Selector

用于查询页面的选择器CSS 选择器可以按原样传入,Puppeteer 特有的选择器语法支持按文本a11y 角色和名称以及xpath进行查询,还支持跨 shadow root 组合这些查询。或者,你也可以使用前缀来指定选择器类型。

返回值:

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

指向与给定选择器匹配的第一个元素的元素句柄。否则为 null