Мышь

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

Каждый объект page имеет свою собственную Мышь, доступную с помощью 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 число

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

• y число

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

• options Объект (необязательно)

  • button "левая" | "правая" | "средняя" (необязательно)

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

  • clickCount число (необязательно)

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

  • delay число (необязательно)

    Время ожидания между 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 число

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

• y число

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

• options Объект (необязательно)

  • button "левая" | "правая" | "средняя" (необязательно)

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

  • delay число (необязательно)

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

Возвращает

• Promise<void>

down​

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

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

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

Аргументы

• options Объект (необязательно)

  • button "левая" | "правая" | "средняя" (необязательно)

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

  • clickCount число (необязательно)

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

Возвращает

• Promise<void>

move​

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

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

await mouse.move(x, y);
await mouse.move(x, y, options);

Аргументы

• x число

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

• y число

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

• options Объект (необязательно)

  • steps число (необязательно)

    По умолчанию 1. Отправляет промежуточные события mousemove.

Возвращает

• Promise<void>

up​

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

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

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

Аргументы

• options Объект (необязательно)

  • button "левая" | "правая" | "средняя" (необязательно)

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

  • clickCount число (необязательно)

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

Возвращает

• Promise<void>

wheel​

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

примечание

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

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

await mouse.wheel(deltaX, deltaY);

Аргументы

• deltaX число

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

• deltaY число

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

Возвращает

• Promise<void>