Mouse

Класс Mouse работает в CSS-пикселях главного фрейма относительно верхнего левого угла области просмотра (viewport).

подсказка

Если вы хотите отладить, куда перемещалась мышь, можно использовать Trace viewer или Playwright Inspector. Для каждого действия мыши будет показана красная точка с её положением.

У каждого объекта page есть собственный Mouse, доступный через page.mouse.

Sync

# использование ‘page.mouse’ для обрисовки квадрата 100x100.
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()

Async

# использование ‘page.mouse’ для обрисовки квадрата 100x100.
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().

Использование

mouse.click(x, y)
mouse.click(x, y, **kwargs)

Аргументы

• x float#

  X координата относительно области просмотра основного фрейма в CSS-пикселях.

• y float#

  Y координата относительно области просмотра основного фрейма в CSS-пикселях.

• button "left" | "right" | "middle" (опционально)#

  По умолчанию left.

• click_count int (опционально)#

  По умолчанию 1. См. UIEvent.detail.

• delay float (опционально)#

  Время ожидания между mousedown и mouseup в миллисекундах. По умолчанию 0.

Возвращает

• NoneType#

---

dblclick

Добавлено до версии v1.9 mouse.dblclick

Является сокращением для mouse.move(), mouse.down(), mouse.up(), mouse.down() и mouse.up().

Использование

mouse.dblclick(x, y)
mouse.dblclick(x, y, **kwargs)

Аргументы

• x float#

  X координата относительно области просмотра основного фрейма в CSS-пикселях.

• y float#

  Y координата относительно области просмотра основного фрейма в CSS-пикселях.

• button "left" | "right" | "middle" (опционально)#

  По умолчанию left.

• delay float (опционально)#

  Время ожидания между mousedown и mouseup в миллисекундах. По умолчанию 0.

Возвращает

• NoneType#

---

down

Добавлено до версии v1.9 mouse.down

Отправляет событие mousedown.

Использование

mouse.down()
mouse.down(**kwargs)

Аргументы

• button "left" | "right" | "middle" (опционально)#

  По умолчанию left.

• click_count int (опционально)#

  По умолчанию 1. См. UIEvent.detail.

Возвращает

• NoneType#

---

move

Добавлено до версии v1.9 mouse.move

Отправляет событие mousemove.

Использование

mouse.move(x, y)
mouse.move(x, y, **kwargs)

Аргументы

• x float#

  X координата относительно области просмотра основного фрейма в CSS-пикселях.

• y float#

  Y координата относительно области просмотра основного фрейма в CSS-пикселях.

• steps int (опционально)#

  По умолчанию 1. Отправляет n интерполированных событий mousemove, чтобы смоделировать перемещение между текущей позицией курсора Playwright и указанной точкой назначения. Если установить 1, будет сгенерировано одно событие mousemove в точке назначения.

Возвращает

• NoneType#

---

up

Добавлено до v1.9 mouse.up

Отправляет событие mouseup.

Использование

mouse.up()
mouse.up(**kwargs)

Аргументы

• button "left" | "right" | "middle" (опционально)#

  По умолчанию left.

• click_count int (опционально)#

  По умолчанию 1. См. UIEvent.detail.

Возвращает

• NoneType#

---

wheel

Добавлено в: v1.15 mouse.wheel

Отправляет событие wheel. Этот метод обычно используется для ручной прокрутки страницы. См. scrolling для альтернативных способов прокрутки.

примечание

События колеса могут вызвать прокрутку, если они не обработаны, и этот метод не ждет завершения прокрутки перед возвратом.

Использование

mouse.wheel(delta_x, delta_y)

Аргументы

• delta_x float#

  Пиксели для горизонтальной прокрутки.

• delta_y float#

  Пиксели для вертикальной прокрутки.

Возвращает

• NoneType#