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

Mouse

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

ヒント

マウスの動きをデバッグしたい場合は、トレースビューアまたはPlaywrightインスペクタを使用できます。すべてのマウスアクションで、マウスの位置を示す赤い点が表示されます。

すべてのpageオブジェクトは、Page.mouse()でアクセスできる独自のマウスを持っています。

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

メソッド​

クリック​

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

Mouse.move()、Mouse.down()、Mouse.up()のショートカット。

使用法

Mouse.click(x, y);
Mouse.click(x, y, options);

引数

  • x double#

    メインフレームのビューポートに対する X 座標 (CSS ピクセル)。

  • y double#

    メインフレームのビューポートに対する Y 座標 (CSS ピクセル)。

  • options Mouse.ClickOptions (任意)

    • setButton enum MouseButton { LEFT, RIGHT, MIDDLE } (任意)#

      デフォルトは left です。

    • setClickCount int (任意)#

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

    • setDelay double (任意)#

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

戻り値

dblclick​

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

Mouse.move()、Mouse.down()、Mouse.up()、Mouse.down()、Mouse.up()のショートカット。

使用法

Mouse.dblclick(x, y);
Mouse.dblclick(x, y, options);

引数

  • x double#

    メインフレームのビューポートに対する X 座標 (CSS ピクセル)。

  • y double#

    メインフレームのビューポートに対する Y 座標 (CSS ピクセル)。

  • options Mouse.DblclickOptions (任意)

    • setButton enum MouseButton { LEFT, RIGHT, MIDDLE } (任意)#

      デフォルトは left です。

    • setDelay double (任意)#

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

戻り値

down​

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

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

使用法

Mouse.down();
Mouse.down(options);

引数

  • options Mouse.DownOptions (任意)

    • setButton enum MouseButton { LEFT, RIGHT, MIDDLE } (任意)#

      デフォルトは left です。

    • setClickCount int (任意)#

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

戻り値

move​

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

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

使用法

Mouse.move(x, y);
Mouse.move(x, y, options);

引数

  • x double#

    メインフレームのビューポートに対する X 座標 (CSS ピクセル)。

  • y double#

    メインフレームのビューポートに対する Y 座標 (CSS ピクセル)。

  • options Mouse.MoveOptions (任意)

    • setSteps int (任意)#

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

戻り値

up​

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

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

使用法

Mouse.up();
Mouse.up(options);

引数

  • options Mouse.UpOptions (任意)

    • setButton enum MouseButton { LEFT, RIGHT, MIDDLE } (任意)#

      デフォルトは left です。

    • setClickCount int (任意)#

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

戻り値

wheel​

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

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

注

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

使用法

Mouse.wheel(deltaX, deltaY);

引数

  • deltaX double#

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

  • deltaY double#

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

戻り値