跳至主要内容
版本：22.5.0

Page.evaluateHandle() 方法

签名：​

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

参数​

参数类型描述
pageFunctionFunc | string在页面中运行的函数
argsParams要传递给 pageFunction 的参数

返回值

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

备注​

page.evaluate 和 page.evaluateHandle 之间的唯一区别是 evaluateHandle 将返回一个包装在页面内对象的返回值。

如果传递给 page.evaluateHandle 的函数返回一个 Promise，该函数将等待 Promise 解决并返回其值。

您可以传递字符串而不是函数（尽管函数更推荐，因为它们更容易调试和与 TypeScript 一起使用）

示例 1​

const aHandle = await page.evaluateHandle('document');

示例 2​

JSHandle 实例可以作为参数传递给 pageFunction

const aHandle = await page.evaluateHandle(() => document.body);
const resultHandle = await page.evaluateHandle(body => body.innerHTML, aHandle);
console.log(await resultHandle.jsonValue());
await resultHandle.dispose();

大多数情况下，此函数返回一个 JSHandle，但如果 pageFunction 返回对元素的引用，您将获得一个 ElementHandle。

示例 3​

const button = await page.evaluateHandle(() =>
  document.querySelector('button')
);
// can call `click` because `button` is an `ElementHandle`
await button.click();

TypeScript 定义假设 evaluateHandle 返回一个 JSHandle，但如果你知道它将返回一个 ElementHandle，请将其作为泛型参数传递

const button = await page.evaluateHandle<ElementHandle>(...);