JSHandle

JSHandle 代表一个页面内的 JavaScript 对象。JSHandle 可以通过 Page.evaluateHandle() 方法创建。

JSHandle windowHandle = page.evaluateHandle("() => window");
// ...

JSHandle 会阻止被引用的 JavaScript 对象被垃圾回收，除非通过 JSHandle.dispose() 方法释放该句柄。当其所属的帧发生导航或其父级上下文被销毁时，JSHandle 会自动释放。

JSHandle 实例可用作 Page.evalOnSelector()、Page.evaluate() 和 Page.evaluateHandle() 方法的参数。

---

方法

asElement

在 v1.9 之前添加 jsHandle.asElement

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

用法

JSHandle.asElement();

返回

• null | ElementHandle#

---

dispose

在 v1.9 之前添加 jsHandle.dispose

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

用法

JSHandle.dispose();

返回

• void#

---

evaluate

在 v1.9 之前添加 jsHandle.evaluate

返回 expression 的返回值。

此方法将当前句柄作为第一个参数传递给 expression。

如果 expression 返回一个 Promise，则 handle.evaluate 将等待该 Promise 完成（resolve）并返回其值。

用法

ElementHandle tweetHandle = page.querySelector(".tweet .retweets");
assertEquals("10 retweets", tweetHandle.evaluate("node => node.innerText"));

参数

• expression String#

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

• arg EvaluationArgument (可选)#

  传递给 expression 的可选参数。

返回

• Object#

---

evaluateHandle

在 v1.9 之前添加 jsHandle.evaluateHandle

以 JSHandle 的形式返回 expression 的返回值。

此方法将当前句柄作为第一个参数传递给 expression。

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

如果传递给 jsHandle.evaluateHandle 的函数返回一个 Promise，则 jsHandle.evaluateHandle 将等待该 Promise 完成（resolve）并返回其值。

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

用法

JSHandle.evaluateHandle(expression);
JSHandle.evaluateHandle(expression, arg);

参数

• expression String#

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

• arg EvaluationArgument (可选)#

  传递给 expression 的可选参数。

返回

• JSHandle#

---

getProperties

在 v1.9 之前添加 jsHandle.getProperties

该方法返回一个 Map，其键是对象的**自有属性名称**，值是对应属性值的 JSHandle 实例。

用法

JSHandle handle = page.evaluateHandle("() => ({ window, document })");
Map<String, JSHandle> properties = handle.getProperties();
JSHandle windowHandle = properties.get("window");
JSHandle documentHandle = properties.get("document");
handle.dispose();

返回

• Map<String, JSHandle>#

---

getProperty

在 v1.9 之前添加 jsHandle.getProperty

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

用法

JSHandle.getProperty(propertyName);

参数

• propertyName String#

  要获取的属性

返回

• JSHandle#

---

jsonValue

在 v1.9 之前添加 jsHandle.jsonValue

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

注意

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

用法

JSHandle.jsonValue();

返回

• Object#