Mouse

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

подсказка

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

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

// Использование ‘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();

---

Методы

click

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

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

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

Mouse.click(x, y);
Mouse.click(x, y, options);

Аргументы

• x double#

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

• y double#

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

• options Mouse.ClickOptions (опционально)

  • setButton enum MouseButton { LEFT, RIGHT, MIDDLE } (опционально)#

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

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

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

  • setDelay double (опционально)#

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

Возвращает

• void#

---

dblclick

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

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

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

Mouse.dblclick(x, y);
Mouse.dblclick(x, y, options);

Аргументы

• x double#

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

• y double#

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

• options Mouse.DblclickOptions (опционально)

  • setButton enum MouseButton { LEFT, RIGHT, MIDDLE } (опционально)#

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

  • setDelay double (опционально)#

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

Возвращает

• void#

---

down

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

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

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

Mouse.down();
Mouse.down(options);

Аргументы

• options Mouse.DownOptions (опционально)

  • setButton enum MouseButton { LEFT, RIGHT, MIDDLE } (опционально)#

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

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

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

Возвращает

• void#

---

move

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

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

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

Mouse.move(x, y);
Mouse.move(x, y, options);

Аргументы

• x double#

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

• y double#

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

• options Mouse.MoveOptions (опционально)

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

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

Возвращает

• void#

---

up

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

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

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

Mouse.up();
Mouse.up(options);

Аргументы

• options Mouse.UpOptions (опционально)

  • setButton enum MouseButton { LEFT, RIGHT, MIDDLE } (опционально)#

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

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

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

Возвращает

• void#

---

wheel

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

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

примечание

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

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

Mouse.wheel(deltaX, deltaY);

Аргументы

• deltaX double#

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

• deltaY double#

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

Возвращает

• void#