ElementHandle.$eval() 方法

在当前元素中，对匹配给定选择器的第一个元素运行给定函数。

如果给定函数返回 Promise，则此方法将等待该 Promise 解析。

签名

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

参数

参数	类型	说明
selector	Selector	选择器用于在页面中查询。CSS 选择器可以按原样传递，Puppeteer 特有的选择器语法允许按文本、无障碍角色和名称和XPath查询，也允许跨 shadow root 组合这些查询。另外，你可以使用前缀指定选择器类型。
pageFunction	Func \| string	要在该元素所在页面的上下文中求值的函数。匹配选择器的第一个元素将作为第一个参数传入。
args	Params	要传递给 `pageFunction` 的其他参数。

返回值：

Promise<Awaited<ReturnType<Func>>>

该函数结果的 Promise。

示例

const tweetHandle = await page.$('.tweet');
expect(await tweetHandle.$eval('.like', node => node.innerText)).toBe('100');
expect(await tweetHandle.$eval('.retweets', node => node.innerText)).toBe('10');