跳到主要内容

JSHandle

JSHandle 代表页面中的 JavaScript 对象。可以通过 page.evaluate_handle() 方法创建 JSHandle。

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

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

JSHandle 实例可以作为参数传递给 page.eval_on_selector()、page.evaluate() 和 page.evaluate_handle() 方法。

方法​

dispose​

v1.9 之前添加 jsHandle.dispose

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

用法

js_handle.dispose()

返回值

evaluate​

v1.9 之前添加 jsHandle.evaluate

返回 expression 的返回值。

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

如果 expression 返回一个 Promise，那么 handle.evaluate 会等待该 promise 解析并返回其值。

用法

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

参数

  • expression str#

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

  • arg EvaluationArgument (可选)#

    传递给 expression 的可选参数。

返回值

evaluate_handle​

v1.9 之前添加 jsHandle.evaluate_handle

返回 expression 的返回值，类型为 JSHandle。

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

jsHandle.evaluate 和 jsHandle.evaluateHandle 唯一的区别是后者返回 JSHandle。

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

更多详情见 page.evaluate_handle()。

用法

js_handle.evaluate_handle(expression)
js_handle.evaluate_handle(expression, **kwargs)

参数

  • expression str#

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

  • arg EvaluationArgument (可选)#

    传递给 expression 的可选参数。

返回值

get_properties​

v1.9 之前添加 jsHandle.get_properties

该方法返回一个以自身属性名为键、属性值为 JSHandle 实例的映射。

用法

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

返回值

get_property​

v1.9 之前添加 jsHandle.get_property

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

用法

js_handle.get_property(property_name)

参数

  • property_name str#

    要获取的属性名

返回值

json_value​

v1.9 之前添加 jsHandle.json_value

返回对象的 JSON 表示。如果对象有 toJSON 方法，不会被调用。

备注

如果被引用对象不可序列化，该方法会返回一个空的 JSON 对象。如果对象存在循环引用，则会抛出错误。

用法

js_handle.json_value()

返回值

属性​

as_element​

v1.9 之前添加 jsHandle.as_element

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

用法

js_handle.as_element()

返回值