Puppeteer 中文文档v25.8.0

Page.$() 方法

查找与选择器匹配的第一个元素。如果没有元素与选择器匹配,则返回值解析为 null

签名

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

参数

参数

类型

说明

selector

Selector

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

返回值:

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

备注

Page.mainFrame().$(selector) 的快捷方式。