Mouse

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

提示

如果您想调试鼠标移动的位置，可以使用跟踪查看器或Playwright Inspector。每次鼠标操作都会显示一个红点，指示鼠标的位置。

每个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 [浮点型]#

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

• y [浮点型]#

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

• options MouseClickOptions? （可选）

  • Button 枚举 MouseButton { Left, Right, Middle }? （可选）#

    默认为 left。

  • ClickCount int? （可选）#

    默认为 1。参见 UIEvent.detail。

  • Delay [浮点型]? （可选）#

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

返回

• void#

---

DblClickAsync

v1.9 之前添加 mouse.DblClickAsync

Mouse.MoveAsync()、Mouse.DownAsync()、Mouse.UpAsync()、Mouse.DownAsync()和Mouse.UpAsync()的快捷方式。

用法

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

参数

• x [浮点型]#

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

• y [浮点型]#

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

• options MouseDblClickOptions? （可选）

  • Button 枚举 MouseButton { Left, Right, Middle }? （可选）#

    默认为 left。

  • Delay [浮点型]? （可选）#

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

返回

• void#

---

DownAsync

v1.9 之前添加 mouse.DownAsync

分发一个 mousedown 事件。

用法

await Mouse.DownAsync(options);

参数

• options MouseDownOptions? （可选）

  • Button 枚举 MouseButton { Left, Right, Middle }? （可选）#

    默认为 left。

  • ClickCount int? （可选）#

    默认为 1。参见 UIEvent.detail。

返回

• void#

---

MoveAsync

v1.9 之前添加 mouse.MoveAsync

分发一个 mousemove 事件。

用法

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

参数

• x [浮点型]#

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

• y [浮点型]#

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

• options MouseMoveOptions? （可选）

  • Steps int? （可选）#

    默认为 1。发送中间的 mousemove 事件。

返回

• void#

---

UpAsync

v1.9 之前添加 mouse.UpAsync

分发一个 mouseup 事件。

用法

await Mouse.UpAsync(options);

参数

• options MouseUpOptions? （可选）

  • Button 枚举 MouseButton { Left, Right, Middle }? （可选）#

    默认为 left。

  • ClickCount int? （可选）#

    默认为 1。参见 UIEvent.detail。

返回

• void#

---

WheelAsync

新增于: v1.15 mouse.WheelAsync

分派一个wheel事件。此方法通常用于手动滚动页面。有关其他滚动方式，请参阅滚动。

注意

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

用法

await Mouse.WheelAsync(deltaX, deltaY);

参数

• deltaX [浮点型]#

  水平滚动的像素。

• deltaY [浮点型]#

  垂直滚动的像素。

返回

• void#