Mouse
Mouse 类以主框架 CSS 像素为单位操作,相对于视口的左上角。
如果你想调试鼠标移动的位置,你可以使用 Trace viewer 或 Playwright Inspector。每次鼠标操作都会显示一个红点,表示鼠标的位置。
每个 page
对象都有自己的鼠标,可以通过 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.move(), mouse.down(), mouse.up() 的快捷方式。
用法
mouse.click(x, y)
mouse.click(x, y, **kwargs)
参数
-
相对于主框架视口在 CSS 像素中的 X 坐标。
-
相对于主框架视口在 CSS 像素中的 Y 坐标。
-
button
"left" | "right" | "middle" (可选)#默认为
left
。 -
默认为 1。参见 UIEvent.detail。
-
mousedown
和mouseup
之间等待的时间(毫秒)。默认为 0。
返回
双击
v1.9 之前添加mouse.move(), mouse.down(), mouse.up(), mouse.down() 和 mouse.up() 的快捷方式。
用法
mouse.dblclick(x, y)
mouse.dblclick(x, y, **kwargs)
参数
-
相对于主框架视口在 CSS 像素中的 X 坐标。
-
相对于主框架视口在 CSS 像素中的 Y 坐标。
-
button
"left" | "right" | "middle" (可选)#默认为
left
。 -
mousedown
和mouseup
之间等待的时间(毫秒)。默认为 0。
返回
按下
v1.9 之前添加分发一个 mousedown
事件。
用法
mouse.down()
mouse.down(**kwargs)
参数
-
button
"left" | "right" | "middle" (可选)#默认为
left
。 -
默认为 1。参见 UIEvent.detail。
返回
移动
v1.9 之前添加分发一个 mousemove
事件。
用法
mouse.move(x, y)
mouse.move(x, y, **kwargs)
参数
-
相对于主框架视口在 CSS 像素中的 X 坐标。
-
相对于主框架视口在 CSS 像素中的 Y 坐标。
-
默认为 1。发送中间的
mousemove
事件。
返回
抬起
v1.9 之前添加分发一个 mouseup
事件。
用法
mouse.up()
mouse.up(**kwargs)
参数
-
button
"left" | "right" | "middle" (可选)#默认为
left
。 -
默认为 1。参见 UIEvent.detail。
返回
滚轮
新增于: v1.15分发一个 wheel
事件。此方法通常用于手动滚动页面。有关其他滚动方式,请参见 滚动。
滚轮事件如果未被处理,可能会导致滚动,并且此方法不会等待滚动完成才返回。
用法
mouse.wheel(delta_x, delta_y)
参数
返回