Mouse

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

ヒント

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

すべてのpageオブジェクトは、page.mouseでアクセスできる独自の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()

非同期

# 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()

---

メソッド

クリック

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

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

使用法

mouse.click(x, y)
mouse.click(x, y, **kwargs)

引数

• x float#

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

• y float#

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

• button "left" | "right" | "middle" (オプション)#

  デフォルトは left です。

• click_count int (オプション)#

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

• delay float (オプション)#

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

戻り値

• NoneType#

---

dblclick

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

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

使用法

mouse.dblclick(x, y)
mouse.dblclick(x, y, **kwargs)

引数

• x float#

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

• y float#

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

• button "left" | "right" | "middle" (オプション)#

  デフォルトは left です。

• delay float (オプション)#

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

戻り値

• NoneType#

---

down

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

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

使用法

mouse.down()
mouse.down(**kwargs)

引数

• button "left" | "right" | "middle" (オプション)#

  デフォルトは left です。

• click_count int (オプション)#

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

戻り値

• NoneType#

---

move

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

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

使用法

mouse.move(x, y)
mouse.move(x, y, **kwargs)

引数

• x float#

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

• y float#

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

• steps int (オプション)#

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

戻り値

• NoneType#

---

up

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

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

使用法

mouse.up()
mouse.up(**kwargs)

引数

• button "left" | "right" | "middle" (オプション)#

  デフォルトは left です。

• click_count int (オプション)#

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

戻り値

• NoneType#

---

wheel

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

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

注

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

使用法

mouse.wheel(delta_x, delta_y)

引数

• delta_x float#

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

• delta_y float#

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

戻り値

• NoneType#