メインコンテンツへスキップ

JSHandle

JSHandle はページ内の JavaScript オブジェクトを表します。JSHandle は Page.evaluateHandle() メソッドで作成できます。

JSHandle windowHandle = page.evaluateHandle("() => window");
// ...

JSHandle は、JSHandle.dispose() でハンドルを公開しない限り、参照されている JavaScript オブジェクトがガベージコレクションされるのを防ぎます。JSHandle は、元のフレームがナビゲートされたり、親コンテキストが破棄されたりすると自動的に破棄されます。

JSHandle インスタンスは、Page.evalOnSelector()、Page.evaluate()、および Page.evaluateHandle() メソッドの引数として使用できます。

メソッド​

asElement​

v1.9 より前に追加 jsHandle.asElement

オブジェクトハンドルが ElementHandle のインスタンスである場合、null またはオブジェクトハンドル自体を返します。

使用例

JSHandle.asElement();

戻り値

dispose​

v1.9 より前に追加 jsHandle.dispose

jsHandle.dispose メソッドは、要素ハンドルへの参照を停止します。

使用例

JSHandle.dispose();

戻り値

evaluate​

v1.9 より前に追加 jsHandle.evaluate

expression の戻り値を返します。

このメソッドは、このハンドルを expression の最初の引数として渡します。

expression が Promise を返す場合、handle.evaluate は Promise が解決されるのを待って、その値を返します。

使用例

ElementHandle tweetHandle = page.querySelector(".tweet .retweets");
assertEquals("10 retweets", tweetHandle.evaluate("node => node.innerText"));

引数

  • expression String#

    ブラウザコンテキストで評価される JavaScript 式。式が関数として評価される場合、関数は自動的に呼び出されます。

  • arg EvaluationArgument (オプション)#

    expression に渡すオプションの引数。

戻り値

evaluateHandle​

v1.9 より前に追加 jsHandle.evaluateHandle

expression の戻り値を JSHandle として返します。

このメソッドは、このハンドルを expression の最初の引数として渡します。

jsHandle.evaluate と jsHandle.evaluateHandle の唯一の違いは、jsHandle.evaluateHandle が JSHandle を返すことです。

jsHandle.evaluateHandle に渡された関数が Promise を返す場合、jsHandle.evaluateHandle は Promise が解決されるのを待って、その値を返します。

詳細については、Page.evaluateHandle() を参照してください。

使用例

JSHandle.evaluateHandle(expression);
JSHandle.evaluateHandle(expression, arg);

引数

  • expression String#

    ブラウザコンテキストで評価される JavaScript 式。式が関数として評価される場合、関数は自動的に呼び出されます。

  • arg EvaluationArgument (オプション)#

    expression に渡すオプションの引数。

戻り値

getProperties​

v1.9 より前に追加 jsHandle.getProperties

このメソッドは、独自のプロパティ名をキーとし、プロパティ値に 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

参照されているオブジェクトから単一のプロパティを取得します。

使用例

JSHandle.getProperty(propertyName);

引数

  • propertyName String#

    取得するプロパティ

戻り値

jsonValue​

v1.9 より前に追加 jsHandle.jsonValue

オブジェクトの JSON 表現を返します。オブジェクトに toJSON 関数がある場合でも、呼び出されません。

注意

参照されているオブジェクトが文字列化できない場合、このメソッドは空の JSON オブジェクトを返します。オブジェクトが循環参照を持っている場合は、エラーをスローします。

使用例

JSHandle.jsonValue();

戻り値