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

JSHandle

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

const windowHandle = await page.evaluateHandle(() => window);
// ...

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

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

メソッド​

asElement​

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

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

使用法

jsHandle.asElement();

戻り値

dispose​

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

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

使用法

await jsHandle.dispose();

戻り値

evaluate​

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

pageFunctionの戻り値を返します。

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

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

使用法

const tweetHandle = await page.$('.tweet .retweets');
expect(await tweetHandle.evaluate(node => node.innerText)).toBe('10 retweets');

引数

戻り値

evaluateHandle​

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

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

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

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

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

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

使用法

await jsHandle.evaluateHandle(pageFunction);
await jsHandle.evaluateHandle(pageFunction, arg);

引数

戻り値

getProperties​

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

このメソッドは、キーとして自身のプロパティ名、値としてプロパティ値のJSHandleインスタンスを持つマップを返します。

使用法

const handle = await page.evaluateHandle(() => ({ window, document }));
const properties = await handle.getProperties();
const windowHandle = properties.get('window');
const documentHandle = properties.get('document');
await handle.dispose();

戻り値

getProperty​

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

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

使用法

await jsHandle.getProperty(propertyName);

引数

  • propertyName string#

    取得するプロパティ

戻り値

jsonValue​

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

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

注

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

使用法

await jsHandle.jsonValue();

戻り値