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

Mouse

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

ヒント

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

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

await Page.Mouse.MoveAsync(0, 0);
await Page.Mouse.DownAsync();
await Page.Mouse.MoveAsync(0, 100);
await Page.Mouse.MoveAsync(100, 100);
await Page.Mouse.MoveAsync(100, 0);
await Page.Mouse.MoveAsync(0, 0);
await Page.Mouse.UpAsync();

メソッド​

ClickAsync​

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

Mouse.MoveAsync()、Mouse.DownAsync()、Mouse.UpAsync()のショートカットです。

使用法

await Mouse.ClickAsync(x, y, options);

引数

  • x [float]#

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

  • y [float]#

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

  • options MouseClickOptions? (任意)

    • Button enum MouseButton { Left, Right, Middle }? (任意)#

      デフォルトは left です。

    • ClickCount int? (任意)#

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

    • Delay [float]? (任意)#

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

戻り値

DblClickAsync​

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

Mouse.MoveAsync()、Mouse.DownAsync()、Mouse.UpAsync()、Mouse.DownAsync()、Mouse.UpAsync()のショートカットです。

使用法

await Mouse.DblClickAsync(x, y, options);

引数

  • x [float]#

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

  • y [float]#

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

  • options MouseDblClickOptions? (任意)

    • Button enum MouseButton { Left, Right, Middle }? (任意)#

      デフォルトは left です。

    • Delay [float]? (任意)#

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

戻り値

DownAsync​

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

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

使用法

await Mouse.DownAsync(options);

引数

  • options MouseDownOptions? (任意)

    • Button enum MouseButton { Left, Right, Middle }? (任意)#

      デフォルトは left です。

    • ClickCount int? (任意)#

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

戻り値

MoveAsync​

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

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

使用法

await Mouse.MoveAsync(x, y, options);

引数

  • x [float]#

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

  • y [float]#

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

  • options MouseMoveOptions? (任意)

    • Steps int? (任意)#

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

戻り値

UpAsync​

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

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

使用法

await Mouse.UpAsync(options);

引数

  • options MouseUpOptions? (任意)

    • Button enum MouseButton { Left, Right, Middle }? (任意)#

      デフォルトは left です。

    • ClickCount int? (任意)#

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

戻り値

WheelAsync​

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

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

注

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

使用法

await Mouse.WheelAsync(deltaX, deltaY);

引数

  • deltaX [float]#

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

  • deltaY [float]#

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

戻り値