Mouse

Mouse 类以主框架 CSS 像素为单位操作，相对于视口的左上角。

提示

如果要调试鼠标移动的位置，可以使用 Trace viewer 或 Playwright Inspector。对于每一次鼠标操作，都会显示一个显示鼠标位置的红点。

每个 page 对象都有其自己的 Mouse，可以通过 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()

异步

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

  相对于主框架视口在 CSS 像素中的 X 坐标。

• y float#

  相对于主框架视口在 CSS 像素中的 Y 坐标。

• button "left" | "right" | "middle" (可选)#

  默认为 left。

• click_count int (可选)#

  默认为 1。参见 UIEvent.detail。

• delay float (可选)#

  mousedown 和 mouseup 之间等待的时间（毫秒）。默认为 0。

返回

• NoneType#

---

双击

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#

  相对于主框架视口在 CSS 像素中的 X 坐标。

• y float#

  相对于主框架视口在 CSS 像素中的 Y 坐标。

• button "left" | "right" | "middle" (可选)#

  默认为 left。

• delay float (可选)#

  mousedown 和 mouseup 之间等待的时间（毫秒）。默认为 0。

返回

• NoneType#

---

按下

v1.9 之前添加 mouse.down

分发一个 mousedown 事件。

用法

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

参数

• button "left" | "right" | "middle" (可选)#

  默认为 left。

• click_count int (可选)#

  默认为 1。参见 UIEvent.detail。

返回

• NoneType#

---

移动

v1.9 之前添加 mouse.move

分发一个 mousemove 事件。

用法

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

参数

• x float#

  相对于主框架视口在 CSS 像素中的 X 坐标。

• y float#

  相对于主框架视口在 CSS 像素中的 Y 坐标。

• steps int (可选)#

  默认为 1。发送 n 个插值过的 mousemove 事件，以表示从 Playwright 当前光标位置到目标位置的移动。当设置为 1 时，将发出一个到达目标位置的 mousemove 事件。

返回

• NoneType#

---

抬起

v1.9 之前添加 mouse.up

分发一个 mouseup 事件。

用法

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

参数

• button "left" | "right" | "middle" (可选)#

  默认为 left。

• click_count int (可选)#

  默认为 1。参见 UIEvent.detail。

返回

• NoneType#

---

滚轮

新增于: v1.15 mouse.wheel

触发一个 wheel 事件。此方法通常用于手动滚动页面。有关滚动的其他方法，请参阅 scrolling。

注意

滚轮事件如果未被处理，可能会导致滚动，并且此方法不会等待滚动完成才返回。

用法

mouse.wheel(delta_x, delta_y)

参数

• delta_x float#

  水平滚动的像素。

• delta_y float#

  垂直滚动的像素。

返回

• NoneType#