Skip to main content

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 для альтернативных способов прокрутки.

note

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

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

await mouse.wheel(deltaX, deltaY);

Аргументы

  • deltaX [number]#

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

  • deltaY [number]#

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

Возвращает

  • [Promise]<[void]>#