Frame.$eval()方法

¥Frame.$eval() method

在框架中与给定选择器匹配的第一个元素上运行给定函数。

¥Runs the given function on the first element matching the given selector in the frame.

如果给定的函数返回一个 Promise，那么此方法将等待直到 Promise 解析。

¥If the given function returns a promise, then this method will wait till the promise resolves.

签名

¥Signature

class Frame {
  $eval<
    Selector extends string,
    Params extends unknown[],
    Func extends EvaluateFuncWith<NodeFor<Selector>, Params> = EvaluateFuncWith<
      NodeFor<Selector>,
      Params
    >,
  >(
    selector: Selector,
    pageFunction: string | Func,
    ...args: Params
  ): Promise<Awaited<ReturnType<Func>>>;
}

参数

¥Parameters

范围	类型	描述
selector	选择器	要查询页面的 selector。CSS 选择器 可以按原样传递，Puppeteer 特定的选择器语法 允许通过 text、a11y 角色和名称、xpath 和 跨影子根组合这些查询 进行查询。或者，你可以使用 prefix 指定选择器类型。
pageFunction	字符串| 功能	要在框架上下文中评估的函数。与选择器匹配的第一个元素将作为其第一个参数传递给函数。
args	参数	要传递给 pageFunction 的其他参数。

Returns:

Promise<Awaited<ReturnType<Func>>>

对函数结果的 promise。

¥A promise to the result of the function.

示例

¥Example

const searchValue = await frame.$eval('#search', el => el.value);