跳至主要内容

JSHandle

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

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

JSHandle 阻止引用的 JavaScript 对象被垃圾回收，除非该句柄通过 js_handle.dispose() 公开。 当它们的原始框架被导航或父上下文被销毁时，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

返回 表达式 的返回值。

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

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

    可选参数，传递给 表达式。

返回值

evaluate_handle​

添加于 v1.9 之前 jsHandle.evaluate_handle

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

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

jsHandle.evaluate 和 jsHandle.evaluateHandle 之间的唯一区别是 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 (可选)#

    可选参数，传递给 表达式。

返回值

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

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

用法

js_handle.as_element()

返回值