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

Mouse

Mouseクラスは、メインフレームのビューポートの左上隅を基準としたCSSピクセルで操作します。

各pageオブジェクトは、page.mouseでアクセスできる独自のMouseを持ちます。

// Using ‘page.mouse’ to trace a 100x100 square.
await page.mouse.move(0, 0);
await page.mouse.down();
await page.mouse.move(0, 100);
await page.mouse.move(100, 100);
await page.mouse.move(100, 0);
await page.mouse.move(0, 0);
await page.mouse.up();

メソッド​

click​

v1.9より前に追加 mouse.click

mouse.move()、mouse.down()、mouse.up()のショートカットです。

使用法

await mouse.click(x, y);
await mouse.click(x, y, options);

引数

  • x 数値#

    メインフレームのビューポートを基準としたX座標（CSSピクセル）。

  • y 数値#

    メインフレームのビューポートを基準としたY座標（CSSピクセル）。

  • options オブジェクト (任意)

    • button 「left」 | 「right」 | 「middle」 (任意)#

      デフォルトはleftです。

    • clickCount 数値 (任意)#

      デフォルトは1です。UIEvent.detailを参照してください。

    • delay 数値 (任意)#

      mousedownとmouseupの間で待機する時間（ミリ秒単位）。デフォルトは0です。

戻り値

dblclick​

v1.9より前に追加 mouse.dblclick

mouse.move()、mouse.down()、mouse.up()、mouse.down()、およびmouse.up()のショートカットです。

使用法

await mouse.dblclick(x, y);
await mouse.dblclick(x, y, options);

引数

  • x 数値#

    メインフレームのビューポートを基準としたX座標（CSSピクセル）。

  • y 数値#

    メインフレームのビューポートを基準としたY座標（CSSピクセル）。

  • options オブジェクト (任意)

    • button 「left」 | 「right」 | 「middle」 (任意)#

      デフォルトはleftです。

    • delay 数値 (任意)#

      mousedownとmouseupの間で待機する時間（ミリ秒単位）。デフォルトは0です。

戻り値

down​

v1.9より前に追加 mouse.down

mousedownイベントをディスパッチします。

使用法

await mouse.down();
await mouse.down(options);

引数

  • options オブジェクト (任意)

    • button 「left」 | 「right」 | 「middle」 (任意)#

      デフォルトはleftです。

    • clickCount 数値 (任意)#

      デフォルトは1です。UIEvent.detailを参照してください。

戻り値

move​

v1.9より前に追加 mouse.move

mousemoveイベントをディスパッチします。

使用法

await mouse.move(x, y);
await mouse.move(x, y, options);

引数

  • x 数値#

    メインフレームのビューポートを基準としたX座標（CSSピクセル）。

  • y 数値#

    メインフレームのビューポートを基準としたY座標（CSSピクセル）。

  • options オブジェクト (任意)

    • steps 数値 (任意)#

      デフォルトは1です。中間的なmousemoveイベントを送信します。

戻り値

up​

v1.9より前に追加 mouse.up

mouseupイベントをディスパッチします。

使用法

await mouse.up();
await mouse.up(options);

引数

  • options オブジェクト (任意)

    • button 「left」 | 「right」 | 「middle」 (任意)#

      デフォルトはleftです。

    • clickCount 数値 (任意)#

      デフォルトは1です。UIEvent.detailを参照してください。

戻り値

wheel​

追加バージョン: v1.15 mouse.wheel

wheelイベントをディスパッチします。このメソッドは通常、ページを手動でスクロールするために使用されます。スクロールの代替方法については、そちらを参照してください。

注

ホイールイベントは、処理されない場合にスクロールを引き起こす可能性があり、このメソッドはスクロールが完了するのを待たずに戻ります。

使用法

await mouse.wheel(deltaX, deltaY);

引数

  • deltaX 数値#

    水平方向にスクロールするピクセル数。

  • deltaY 数値#

    垂直方向にスクロールするピクセル数。

戻り値