鼠标

Mouse类在主框架的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();

方法​

点击​

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

用法

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

参数

• x number#

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

• y number#

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

• options Object (可选)

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

    默认为 left。

  • clickCount number (可选)#

    默认为1。参见UIEvent.detail。

  • delay number (可选)#

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

返回

• Promise<void>#

双击​

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

用法

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

参数

• x number#

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

• y number#

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

• options Object (可选)

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

    默认为 left。

  • delay number (可选)#

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

返回

• Promise<void>#

下载​

派发一个mousedown事件。

用法

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

参数

• options Object (optional)

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

    默认为 left。

  • clickCount number (可选)#

    默认为1。参见UIEvent.detail。

返回

• Promise<void>#

移动​

派发一个mousemove事件。

用法

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

参数

• x number#

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

• y number#

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

• options Object (可选)

  • steps number (可选)#

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

返回

• Promise<void>#

向上​

触发一个 mouseup 事件。

用法

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

参数

• options Object (optional)

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

    默认为 left。

  • clickCount number (可选)#

    默认为1。参见UIEvent.detail。

返回

• Promise<void>#

wheel​

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

用法

await mouse.wheel(deltaX, deltaY);

参数

• deltaX number#

  水平滚动的像素值。

• deltaY number#

  垂直滚动的像素数。

返回

• Promise<void>#