ElementHandle.$$eval() 方法

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

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

签名：

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

参数

参数	类型	说明
selector	选择器	要查询的选择器。
pageFunction	Func | string	要在元素的页面上下文中评估的函数。与给定选择器匹配的元素数组将作为其第一个参数传递给该函数。
args	参数	要传递给 pageFunction 的其他参数。

返回

Promise<Awaited<ReturnType<Func>>>

函数结果的 Promise。

示例

HTML

<div class="feed">
  <div class="tweet">Hello!</div>
  <div class="tweet">Hi!</div>
</div>

JavaScript

const feedHandle = await page.$('.feed');
expect(
  await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText))
).toEqual(['Hello!', 'Hi!']);