Mouse

Mouse 类在主框架的 CSS 像素坐标系中操作,坐标相对于视口左上角。

每个 page 对象都有自己的 Mouse,可通过 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.click(x, y[, options])
• mouse.dblclick(x, y[, options])
• mouse.down([options])
• mouse.move(x, y[, options])
• mouse.up([options])
• mouse.wheel(deltaX, deltaY)

mouse.click(x, y[, options])

Added in: v1.8

• x <number>#
• y <number>#
• options? <Object>
  • button? <"left"|"right"|"middle"> 默认为 left。#
  • clickCount? <number> 默认为 1。参见 UIEvent.detail。#
  • delay? <number> mousedown 和 mouseup 之间的等待时间(以毫秒为单位)。默认为 0。#
• returns: <Promise<void>>#

mouse.move(x, y[, options])、mouse.down([options])、mouse.up([options]) 的快捷方式。

mouse.dblclick(x, y[, options])

Added in: v1.8

• x <number>#
• y <number>#
• options? <Object>
  • button? <"left"|"right"|"middle"> 默认为 left。#
  • delay? <number> mousedown 和 mouseup 之间的等待时间(以毫秒为单位)。默认为 0。#
• returns: <Promise<void>>#

mouse.move(x, y[, options])、mouse.down([options])、mouse.up([options])、mouse.down([options]) 和 mouse.up([options]) 的快捷方式。

mouse.down([options])

Added in: v1.8

• options? <Object>
  • button? <"left"|"right"|"middle"> 默认为 left。#
  • clickCount? <number> 默认为 1。参见 UIEvent.detail。#
• returns: <Promise<void>>#

触发 mousedown 事件。

mouse.move(x, y[, options])

Added in: v1.8

• x <number>#
• y <number>#
• options? <Object>
  • steps? <number> 默认为 1。发送中间的 mousemove 事件。#
• returns: <Promise<void>>#

触发 mousemove 事件。

mouse.up([options])

Added in: v1.8

• options? <Object>
  • button? <"left"|"right"|"middle"> 默认为 left。#
  • clickCount? <number> 默认为 1。参见 UIEvent.detail。#
• returns: <Promise<void>>#

触发 mouseup 事件。

mouse.wheel(deltaX, deltaY)

Added in: v1.15

• deltaX <number> 水平滚动的像素数。#
• deltaY <number> 垂直滚动的像素数。#
• returns: <Promise<void>>#

触发 wheel 事件。

note

如果滚轮事件未被处理,可能会导致滚动,此方法不会等待滚动完成后再返回。