Mouse

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

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

подсказка

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

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

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

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

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>#

---

dblclick

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

Является сокращением для 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>#

---

down

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

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

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

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

Аргументы

• options Object (опционально)

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

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

  • clickCount number (опционально)#

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

Возвращает

• Promise<void>#

---

move

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

Отправляет событие 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. Отправляет n интерполированных событий mousemove, чтобы смоделировать перемещение между текущей позицией курсора Playwright и указанной точкой назначения. Если установить 1, будет сгенерировано одно событие mousemove в точке назначения.

Возвращает

• Promise<void>#

---

up

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

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

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

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

Аргументы

• options Object (опционально)

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

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

  • clickCount number (опционально)#

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

Возвращает

• Promise<void>#

---

wheel

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

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

примечание

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

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

await mouse.wheel(deltaX, deltaY);

Аргументы

• deltaX number#

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

• deltaY number#

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

Возвращает

• Promise<void>#