JSHandle
JSHandle 代表頁面內的 JavaScript 物件。JSHandle 可以使用 Page.evaluateHandle() 方法建立。
JSHandle windowHandle = page.evaluateHandle("() => window");
// ...
除非使用 JSHandle.dispose() 公開控制代碼，否則 JSHandle 會防止參考的 JavaScript 物件遭到垃圾回收。當其原始框架導航或父內容遭到銷毀時，JSHandle 會自動處置。
JSHandle 執行個體可以用作 Page.evalOnSelector()、Page.evaluate() 和 Page.evaluateHandle() 方法中的引數。
方法
asElement
在 v1.9 之前新增如果物件控制代碼是 ElementHandle 的執行個體，則傳回 null 或物件控制代碼本身。
用法
JSHandle.asElement();
傳回
dispose
在 v1.9 之前新增jsHandle.dispose 方法會停止參考元素控制代碼。
用法
JSHandle.dispose();
傳回
evaluate
在 v1.9 之前新增傳回 expression 的傳回值。
此方法會將此控制代碼作為第一個引數傳遞至 expression。
如果 expression 傳回 Promise，則 handle.evaluate 會等待 Promise 解析並傳回其值。
用法
ElementHandle tweetHandle = page.querySelector(".tweet .retweets");
assertEquals("10 retweets", tweetHandle.evaluate("node => node.innerText"));
引數
-
要在瀏覽器內容中評估的 JavaScript 運算式。如果運算式評估為函式，則會自動叫用該函式。
-
argEvaluationArgument (選用)#要傳遞至 expression 的選用引數。
傳回
evaluateHandle
在 v1.9 之前新增以 JSHandle 形式傳回 expression 的傳回值。
此方法會將此控制代碼作為第一個引數傳遞至 expression。
jsHandle.evaluate 和 jsHandle.evaluateHandle 之間的唯一差異在於 jsHandle.evaluateHandle 會傳回 JSHandle。
如果傳遞至 jsHandle.evaluateHandle 的函式傳回 Promise，則 jsHandle.evaluateHandle 會等待 Promise 解析並傳回其值。
如需更多詳細資訊，請參閱 Page.evaluateHandle()。
用法
JSHandle.evaluateHandle(expression);
JSHandle.evaluateHandle(expression, arg);
引數
-
要在瀏覽器內容中評估的 JavaScript 運算式。如果運算式評估為函式，則會自動叫用該函式。
-
argEvaluationArgument (選用)#要傳遞至 expression 的選用引數。
傳回
getProperties
在 v1.9 之前新增此方法會傳回一個地圖，其中自有屬性名稱作為索引鍵，而 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();
傳回
getProperty
在 v1.9 之前新增從參考的物件擷取單一屬性。
用法
JSHandle.getProperty(propertyName);
引數
傳回
jsonValue
在 v1.9 之前新增傳回物件的 JSON 表示法。如果物件具有 toJSON 函式，則不會呼叫該函式。
如果參考的物件無法字串化，則此方法會傳回空的 JSON 物件。如果物件具有循環參考，則會擲回錯誤。
用法
JSHandle.jsonValue();
傳回