Перейти к основному содержимому

Mouse

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

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

подсказка

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

Каждый объект page имеет собственный Mouse, доступный через Page.Mouse.

await Page.Mouse.MoveAsync(0, 0);
await Page.Mouse.DownAsync();
await Page.Mouse.MoveAsync(0, 100);
await Page.Mouse.MoveAsync(100, 100);
await Page.Mouse.MoveAsync(100, 0);
await Page.Mouse.MoveAsync(0, 0);
await Page.Mouse.UpAsync();

Методы​

ClickAsync​

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

Является сокращением для Mouse.MoveAsync(), Mouse.DownAsync(), Mouse.UpAsync().

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

await Mouse.ClickAsync(x, y, options);

Аргументы

  • x [float]#

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

  • y [float]#

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

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

    • Button enum MouseButton { Left, Right, Middle }? (опционально)#

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

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

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

    • Delay [float]? (опционально)#

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

Возвращает

DblClickAsync​

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

Является сокращением для Mouse.MoveAsync(), Mouse.DownAsync(), Mouse.UpAsync(), Mouse.DownAsync() и Mouse.UpAsync().

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

await Mouse.DblClickAsync(x, y, options);

Аргументы

  • x [float]#

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

  • y [float]#

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

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

    • Button enum MouseButton { Left, Right, Middle }? (опционально)#

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

    • Delay [float]? (опционально)#

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

Возвращает

DownAsync​

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

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

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

await Mouse.DownAsync(options);

Аргументы

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

    • Button enum MouseButton { Left, Right, Middle }? (опционально)#

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

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

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

Возвращает

MoveAsync​

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

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

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

await Mouse.MoveAsync(x, y, options);

Аргументы

  • x [float]#

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

  • y [float]#

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

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

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

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

Возвращает

UpAsync​

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

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

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

await Mouse.UpAsync(options);

Аргументы

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

    • Button enum MouseButton { Left, Right, Middle }? (опционально)#

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

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

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

Возвращает

WheelAsync​

Добавлено в версии: v1.15 mouse.WheelAsync

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

примечание

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

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

await Mouse.WheelAsync(deltaX, deltaY);

Аргументы

  • deltaX [float]#

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

  • deltaY [float]#

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

Возвращает