JSHandle

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

var windowHandle = await page.EvaluateHandleAsync("() => window");

除非使用 JsHandle.DisposeAsync() 公開控制代碼，否則 JSHandle 會防止參考的 JavaScript 物件被垃圾回收。當其來源框架導航或父內容被銷毀時，JSHandle 會自動處置。

JSHandle 實例可以用作 Page.EvalOnSelectorAsync()、Page.EvaluateAsync() 和 Page.EvaluateHandleAsync() 方法中的引數。

---

方法

AsElement

在 v1.9 之前新增 jsHandle.AsElement

如果物件控制代碼是 ElementHandle 的實例，則傳回 null 或物件控制代碼本身。

用法

JsHandle.AsElement();

傳回

• ElementHandle?#

---

DisposeAsync

在 v1.9 之前新增 jsHandle.DisposeAsync

jsHandle.dispose 方法會停止參考元素控制代碼。

用法

await JsHandle.DisposeAsync();

傳回

• void#

---

EvaluateAsync

在 v1.9 之前新增 jsHandle.EvaluateAsync

傳回 expression 的傳回值。

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

如果 expression 傳回 Promise，則 handle.evaluate 將等待 Promise 解析並傳回其值。

用法

var tweetHandle = await page.QuerySelectorAsync(".tweet .retweets");
Assert.AreEqual("10 retweets", await tweetHandle.EvaluateAsync("node => node.innerText"));

引數

• expression string#

  要在瀏覽器內容中評估的 JavaScript 運算式。如果運算式評估為函式，則會自動叫用該函式。

• arg EvaluationArgument? (選用)#

  要傳遞給 expression 的選用引數。

傳回

• [object]#

---

EvaluateHandleAsync

在 v1.9 之前新增 jsHandle.EvaluateHandleAsync

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

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

jsHandle.evaluate 和 jsHandle.evaluateHandle 之間的唯一區別在於 jsHandle.evaluateHandle 傳回 JSHandle。

如果傳遞給 jsHandle.evaluateHandle 的函式傳回 Promise，則 jsHandle.evaluateHandle 將等待 Promise 解析並傳回其值。

有關更多詳細資訊，請參閱 Page.EvaluateHandleAsync()。

用法

await JsHandle.EvaluateHandleAsync(expression, arg);

引數

• expression string#

  要在瀏覽器內容中評估的 JavaScript 運算式。如果運算式評估為函式，則會自動叫用該函式。

• arg EvaluationArgument? (選用)#

  要傳遞給 expression 的選用引數。

傳回

• JSHandle#

---

GetPropertiesAsync

在 v1.9 之前新增 jsHandle.GetPropertiesAsync

此方法會傳回一個地圖，其中包含自有屬性名稱作為索引鍵，以及屬性值的 JSHandle 實例。

用法

var handle = await page.EvaluateHandleAsync("() => ({ window, document }");
var properties = await handle.GetPropertiesAsync();
var windowHandle = properties["window"];
var documentHandle = properties["document"];
await handle.DisposeAsync();

傳回

• [Map]<string, JSHandle>#

---

GetPropertyAsync

在 v1.9 之前新增 jsHandle.GetPropertyAsync

從參考的物件擷取單一屬性。

用法

await JsHandle.GetPropertyAsync(propertyName);

引數

• propertyName string#

  要取得的屬性

傳回

• JSHandle#

---

JsonValueAsync

在 v1.9 之前新增 jsHandle.JsonValueAsync

傳回物件的 JSON 表示法。如果物件具有 toJSON 函式，則不會呼叫它。

注意

如果參考的物件不可字串化，則此方法會傳回空的 JSON 物件。如果物件有循環參考，則會擲回錯誤。

用法

await JsHandle.JsonValueAsync();

傳回

• [object]#