跳到主要內容

JSHandle

JSHandle 代表頁面內的 JavaScript 物件。JSHandle 可以使用 page.evaluate_handle() 方法建立。

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

除非使用 js_handle.dispose() 公開處理，否則 JSHandle 會防止參照的 JavaScript 物件被垃圾回收。當其原始框架導航或父內容被銷毀時，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

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

此方法將此控制代碼作為第一個引數傳遞給 expression。

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 (選用)#

    要傳遞給 expression 的選用引數。

回傳

get_properties​

在 v1.9 之前新增 jsHandle.get_properties

此方法會回傳一個 map，其中包含自有屬性名稱作為鍵，以及屬性值的 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()

回傳