Skip to main content

JSHandle

JSHandle 表示页面内的 JavaScript 对象。可以使用 page.evaluate_handle(expression, **kwargs) 方法创建 JSHandles。

window_handle = page.evaluate_handle("window")
# ...

JSHandle 防止引用的 JavaScript 对象被垃圾回收，除非使用 js_handle.dispose() 释放句柄。当其原始 frame 导航或父上下文被销毁时，JSHandles 会自动释放。

JSHandle 实例可用作 page.eval_on_selector(selector, expression, **kwargs), page.evaluate(expression, **kwargs) 和 page.evaluate_handle(expression, **kwargs) 方法的参数。

js_handle.as_element()​

Added in: v1.8

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

js_handle.dispose()​

Added in: v1.8

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

js_handle.evaluate(expression, **kwargs)​

Added in: v1.8
  • expression <str> 要在浏览器上下文中求值的 JavaScript 表达式。如果表达式求值为函数，则会自动调用该函数。#
  • arg <EvaluationArgument> 传递给 expression 的可选参数。#
  • 返回值: <Serializable>#

返回 expression 的返回值。

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

如果 expression 返回 Promise，则 handle.evaluate 将等待 promise 解析并返回其值。

Examples:

tweet_handle = page.query_selector(".tweet .retweets")
assert tweet_handle.evaluate("node => node.innerText") == "10 retweets"

js_handle.evaluate_handle(expression, **kwargs)​

Added in: v1.8
  • expression <str> 要在浏览器上下文中求值的 JavaScript 表达式。如果表达式求值为函数，则会自动调用该函数。#
  • arg <EvaluationArgument> 传递给 expression 的可选参数。#
  • 返回值: <JSHandle>#

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

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

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

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

有关详细信息，请参阅 page.evaluate_handle(expression, **kwargs)。

js_handle.get_properties()​

Added in: v1.8

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

handle = page.evaluate_handle("{window, document}")
properties = handle.get_properties()
window_handle = properties.get("window")
document_handle = properties.get("document")
handle.dispose()

js_handle.get_property(property_name)​

Added in: v1.8

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

js_handle.json_value()​

Added in: v1.8

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

note

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