Skip to main content
Deno 2 is finally here 🎉️
Learn more
Module

x/pptr/mod.ts>Mouse

Headless Chrome Deno API
Latest
class Mouse
Re-export
import { Mouse } from "https://deno.land/x/pptr@1.2.0/mod.ts";

The Mouse class operates in main-frame CSS pixels relative to the top-left corner of the viewport.

Examples

Example 1

// 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();

Note: The mouse events trigger synthetic MouseEvents. This means that it does not fully replicate the functionality of what a normal user would be able to do with their mouse.

For example, dragging and selecting text is not possible using page.mouse. Instead, you can use the DocumentOrShadowRoot.getSelection() functionality implemented in the platform.

For example, if you want to select all content between nodes:

await page.evaluate((from, to) => {
  const selection = from.getRootNode().getSelection();
  const range = document.createRange();
  range.setStartBefore(from);
  range.setEndAfter(to);
  selection.removeAllRanges();
  selection.addRange(range);
}, fromJSHandle, toJSHandle);

If you then would want to copy-paste your selection, you can use the clipboard api:

// The clipboard api does not allow you to copy, unless the tab is focused.
await page.bringToFront();
await page.evaluate(() => {
  // Copy the selected content to the clipboard
  document.execCommand('copy');
  // Obtain the content of the clipboard as a string
  return navigator.clipboard.readText();
});

Note: If you want access to the clipboard API, you have to give it permission to do so:

await browser.defaultBrowserContext().overridePermissions(
  '<your origin>', ['clipboard-read', 'clipboard-write']
);

Constructors

new
Mouse(client: CDPSession, keyboard: Keyboard)

Properties

private
_button: MouseButton | "none"
private
_client: CDPSession
private
_keyboard: Keyboard
private
_x: number
private
_y: number

Methods

click(
x: number,
y: number,
options?: MouseOptions & { delay?: number; },
): Promise<void>

Shortcut for mouse.move, mouse.down and mouse.up.

down(options?: MouseOptions): Promise<void>

Dispatches a mousedown event.

move(
x: number,
y: number,
options?: { steps?: number; },
): Promise<void>

Dispatches a mousemove event.

up(options?: MouseOptions): Promise<void>

Dispatches a mouseup event.

wheel(options?: MouseWheelOptions): Promise<void>

Dispatches a mousewheel event.