鼠标

鼠标类在相对于视窗左上角的主框架 CSS 像素中运行。

每个 page 对象都有自己的鼠标，可以通过 page.mouse 访问。

// 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();

---

方法

click

在 v1.9 之前添加 mouse.click

是 mouse.move()、mouse.down()、mouse.up() 的快捷方式。

用法

await mouse.click(x, y);
await mouse.click(x, y, options);

参数

• x 数字#

  相对于主框架视窗的 X 坐标，以 CSS 像素为单位。

• y 数字#

  相对于主框架视窗的 Y 坐标，以 CSS 像素为单位。

• options 对象 (可选)

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

    默认为 left。

  • clickCount 数字 (可选)#

    默认为 1。参见 UIEvent.detail。

  • delay 数字 (可选)#

    在 mousedown 和 mouseup 之间等待的时间，以毫秒为单位。默认为 0。

返回

• Promise<void>#

---

dblclick

在 v1.9 之前添加 mouse.dblclick

是 mouse.move()、mouse.down()、mouse.up()、mouse.down() 和 mouse.up() 的快捷方式。

用法

await mouse.dblclick(x, y);
await mouse.dblclick(x, y, options);

参数

• x 数字#

  相对于主框架视窗的 X 坐标，以 CSS 像素为单位。

• y 数字#

  相对于主框架视窗的 Y 坐标，以 CSS 像素为单位。

• options 对象 (可选)

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

    默认为 left。

  • delay 数字 (可选)#

    在 mousedown 和 mouseup 之间等待的时间，以毫秒为单位。默认为 0。

返回

• Promise<void>#

---

down

在 v1.9 之前添加 mouse.down

分发 mousedown 事件。

用法

await mouse.down();
await mouse.down(options);

参数

• options 对象 (可选)

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

    默认为 left。

  • clickCount 数字 (可选)#

    默认为 1。参见 UIEvent.detail。

返回

• Promise<void>#

---

move

在 v1.9 之前添加 mouse.move

分发 mousemove 事件。

用法

await mouse.move(x, y);
await mouse.move(x, y, options);

参数

• x 数字#

  相对于主框架视窗的 X 坐标，以 CSS 像素为单位。

• y 数字#

  相对于主框架视窗的 Y 坐标，以 CSS 像素为单位。

• options 对象 (可选)

  • steps 数字 (可选)#

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

返回

• Promise<void>#

---

up

在 v1.9 之前添加 mouse.up

分发 mouseup 事件。

用法

await mouse.up();
await mouse.up(options);

参数

• options 对象 (可选)

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

    默认为 left。

  • clickCount 数字 (可选)#

    默认为 1。参见 UIEvent.detail。

返回

• Promise<void>#

---

wheel

在以下版本中添加：v1.15 mouse.wheel

分发 wheel 事件。此方法通常用于手动滚动页面。参见 滚动 以了解滚动页面的其他方法。

注意

如果未处理滚轮事件，可能会导致滚动，此方法在返回之前不会等待滚动完成。

用法

await mouse.wheel(deltaX, deltaY);

参数

• deltaX 数字#

  水平滚动的像素。

• deltaY 数字#

  垂直滚动的像素。

返回

• Promise<void>#