Mouse

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

Каждый объект 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. Отправляет промежуточные события 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>#