跳到主要内容

JSHandle

JSHandle 表示页面内的 JavaScript 对象。可以使用 Page.EvaluateHandleAsync() 方法创建 JSHandle。

var windowHandle = await page.EvaluateHandleAsync("() => window");

JSHandle 会阻止被引用的 JavaScript 对象被垃圾回收，除非通过 JsHandle.DisposeAsync() 释放该 handle。JSHandles 在其源框架导航或父上下文销毁时会自动释放。

JSHandle 实例可以用作 Page.EvalOnSelectorAsync()、Page.EvaluateAsync() 和 Page.EvaluateHandleAsync() 方法的参数。

方法​

AsElement​

在 v1.9 之前添加 jsHandle.AsElement

如果对象 handle 是 ElementHandle 的实例，则返回 null 或对象 handle 本身。

用法

JsHandle.AsElement();

返回

DisposeAsync​

在 v1.9 之前添加 jsHandle.DisposeAsync

jsHandle.dispose 方法停止引用元素 handle。

用法

await JsHandle.DisposeAsync();

返回

EvaluateAsync​

在 v1.9 之前添加 jsHandle.EvaluateAsync

返回 expression 的返回值。

此方法将此 handle 作为第一个参数传递给 expression。

如果 expression 返回一个 Promise，则 handle.evaluate 将等待 Promise 解决并返回其值。

用法

var tweetHandle = await page.QuerySelectorAsync(".tweet .retweets");
Assert.AreEqual("10 retweets", await tweetHandle.EvaluateAsync("node => node.innerText"));

参数

  • expression string#

    要在浏览器上下文中评估的 JavaScript 表达式。如果表达式评估为一个函数，则该函数会自动调用。

  • arg EvaluationArgument? （可选）#

    要传递给 expression 的可选参数。

返回

  • [object]#

EvaluateHandleAsync​

在 v1.9 之前添加 jsHandle.EvaluateHandleAsync

返回 expression 的返回值，作为一个 JSHandle。

此方法将此 handle 作为第一个参数传递给 expression。

jsHandle.evaluate 和 jsHandle.evaluateHandle 之间唯一的区别是 jsHandle.evaluateHandle 返回一个 JSHandle。

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

有关更多详细信息，请参阅 Page.EvaluateHandleAsync()。

用法

await JsHandle.EvaluateHandleAsync(expression, arg);

参数

  • expression string#

    要在浏览器上下文中评估的 JavaScript 表达式。如果表达式评估为一个函数，则该函数会自动调用。

  • arg EvaluationArgument? （可选）#

    要传递给 expression 的可选参数。

返回

GetPropertiesAsync​

在 v1.9 之前添加 jsHandle.GetPropertiesAsync

该方法返回一个 Map，其中键是自身属性名称，值是属性值的 JSHandle 实例。

用法

var handle = await page.EvaluateHandleAsync("() => ({ window, document }");
var properties = await handle.GetPropertiesAsync();
var windowHandle = properties["window"];
var documentHandle = properties["document"];
await handle.DisposeAsync();

返回

GetPropertyAsync​

在 v1.9 之前添加 jsHandle.GetPropertyAsync

从被引用的对象中获取单个属性。

用法

await JsHandle.GetPropertyAsync(propertyName);

参数

  • propertyName string#

    要获取的属性

返回

JsonValueAsync​

在 v1.9 之前添加 jsHandle.JsonValueAsync

返回对象的 JSON 表示。如果对象有 toJSON 函数，它将不会被调用。

注意

如果被引用的对象不可序列化为字符串，该方法将返回一个空的 JSON 对象。如果对象有循环引用，它将抛出错误。

用法

await JsHandle.JsonValueAsync();

返回

  • [object]#