Puppeteer 中文文档v25.8.0

Realm.evaluateHandle() 方法

在 realm 的上下文中求值一个函数,并返回指向结果的 JSHandle

如果传递给 realm.evaluateHandle 的函数返回 Promise,该方法将等待该 promise 解析并返回其值。

JSHandle 实例可以作为参数传递给该函数。

签名

class Realm {
  abstract evaluateHandle<
    Params extends unknown[],
    Func extends EvaluateFunc<Params> = EvaluateFunc<Params>,
  >(
    pageFunction: Func | string,
    ...args: Params
  ): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
}

参数

参数

类型

说明

pageFunction

Func | string

要在 realm 中求值的函数。

args

Params

要传递给 pageFunction 的参数。

返回值:

Promise<HandleFor<Awaited<ReturnType<Func>>>>

一个解析为包含结果的 JSHandle 的 promise。

示例

const aHandle = await realm.evaluateHandle(() => document.body);
const resultHandle = await realm.evaluateHandle(
  body => body.innerHTML,
  aHandle,
);