JSHandle

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

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

JSHandle 防止引用的 JavaScript 对象被垃圾回收，除非该句柄使用 JsHandle.DisposeAsync() 公开。当 JSHandle 的源框架被导航或父上下文被销毁时，JSHandle 会自动释放。

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

---

方法

AsElement

在 v1.9 之前添加 jsHandle.AsElement

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

用法

JsHandle.AsElement();

返回值

• ElementHandle?#

---

DisposeAsync

在 v1.9 之前添加 jsHandle.DisposeAsync

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

用法

await JsHandle.DisposeAsync();

返回值

• void#

---

EvaluateAsync

在 v1.9 之前添加 jsHandle.EvaluateAsync

返回 表达式 的返回值。

此方法将此句柄作为第一个参数传递给 表达式。

如果 表达式 返回一个 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? (可选)#

  要传递给 表达式 的可选参数。

返回值

• [object]#

---

EvaluateHandleAsync

在 v1.9 之前添加 jsHandle.EvaluateHandleAsync

将 表达式 的返回值作为 JSHandle 返回。

此方法将此句柄作为第一个参数传递给 表达式。

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? (可选)#

  要传递给 表达式 的可选参数。

返回值

• JSHandle#

---

GetPropertiesAsync

在 v1.9 之前添加 jsHandle.GetPropertiesAsync

该方法返回一个映射，其中 **自身属性名称** 作为键，JSHandle 实例作为属性值。

用法

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

返回值

• [Map]<string, JSHandle>#

---

GetPropertyAsync

在 v1.9 之前添加 jsHandle.GetPropertyAsync

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

用法

await JsHandle.GetPropertyAsync(propertyName);

参数

• propertyName string#

  要获取的属性

返回值

• JSHandle#

---

JsonValueAsync

在 v1.9 之前添加 jsHandle.JsonValueAsync

返回对象的 JSON 表示形式。如果对象具有 toJSON 函数，则 **不会调用该函数**。

注意

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

用法

await JsHandle.JsonValueAsync();

返回值

• [object]#