Mouse

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

совет

Чтобы отладить перемещение мыши, можно использовать просмотрщик трассировок или инспектор Playwright. При каждом действии мыши будет отображаться красная точка, показывающая её местоположение.

У каждого объекта 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();

Методы​

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​

Сокращённая запись для 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​

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

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

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

Аргументы

• options Object (необязательно)

  • button "left" | "right" | "middle" (необязательно)

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

  • clickCount number (необязательно)

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

Возвращает

• Promise<void>

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​

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

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

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

Аргументы

• options Object (необязательно)

  • button "left" | "right" | "middle" (необязательно)

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

  • clickCount number (необязательно)

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

Возвращает

• Promise<void>

wheel​

Отправляет событие wheel. Этот метод обычно используется для прокрутки страницы вручную. Другие способы прокрутки см. в разделе прокрутка.

примечание

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

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

await mouse.wheel(deltaX, deltaY);

Аргументы

• deltaX number

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

• deltaY number

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

Возвращает

• Promise<void>