Puppeteer 中文文档v25.8.0

Page.locator() 方法

locator(): Locator<NodeFor<Selector>>

为提供的选择器创建一个定位器。有关详细信息和受支持的操作,请参阅 Locator

签名

class Page {
  locator<Selector extends string>(
    selector: Selector,
  ): Locator<NodeFor<Selector>>;
}

参数

参数

类型

说明

selector

Selector

用于查询页面的 selectorCSS 选择器 可以直接传入,Puppeteer 特有的选择器语法 允许按 texta11y role 和 namexpath 查询,并支持跨 shadow roots 组合这些查询。此外,你也可以使用前缀来指定选择器类型。

返回值:

Locator<NodeFor<Selector>>

locator(): Locator<Ret>

为提供的函数创建一个定位器。有关详细信息和受支持的操作,请参阅 Locator

签名

class Page {
  locator<Ret>(func: () => Awaitable<Ret>): Locator<Ret>;
}

参数

参数

类型

说明

func

() => Awaitable<Ret>

返回值:

Locator<Ret>