Skip to content

Modification of actual ghost-cursor for puppeteer, with more functionality and rewrited to work well with playwight.

Notifications You must be signed in to change notification settings

reaz1995/ghost-cursor-playwright

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ghost-cursor-playwright

Modification of actual ghost-cursor for puppeteer, with more functionality and rewrite to work well with playwright. Note! target elements rendered in the DOM will be scrolled vertically and horizontally to be visible in viewport

Download

git clone https://github.com/reaz1995/ghost-cursor-playwright.git cursor
cd cursor
npm install

example of usage in src/example.ts to run example use

npm run example

for wsl2 don't forget to set up display

Download as package

npm i ghost-cursor-playwright
import { createCursor } from 'ghost-cursor-playwright';
or;
const { createCursor } = require('ghost-cursor-playwright');

How to use

Create amd attach cursor to page

const cursor = await createCursor(page);

manipulate the cursor via:

cursor.actions.move(target: string | BoundingBox | Vector, moveOptions?: moveOptions): Promise<void>;

type moveOptions = {
	paddingPercentage?: number;
	waitForSelector?: number;
	waitBeforeMove?: [number, number];
};


cursor.actions.click(clickOptions?: clickOptions, moveOptions?: moveOptions): Promise<void>;

type clickOptions = {
	target?: string | BoundingBox | Vector;
	waitBeforeClick?: [number, number];
	waitBetweenClick?: [number, number];
	doubleClick?: boolean;
};
// if target is given then cursor will use move function before click
// if target is JS path string, then function will check if for sure is on correct target (sometimes rendered objects are covered in viewport by menu bar or dialogs etc.), if false will proceed fallback to native click

util functions

// actual position of cursor is mounted on window.mousePos, its value can be retrieve by
  cursor.getActualPosOfMouse(): Promise<Vector>;

// actual target of cursor is mounted on window.mouseTarget, to compare target under cursor with given JS PATH selector use:
  cursor.compareTargetOfMouse(selector: string): Promise<boolean>

// random Vector of element
  cursor.getElemBoundingBox(selector: string): Promise<BoundingBox>
  cursor.getRandomPointInsideElem(elemBoundingBox: BoundingBox, paddingPercentage?): Vector

// random Vector of viewport
  cursor.getRandomPointOnViewport(paddingPercentage?): Promise<Vector>

About

Modification of actual ghost-cursor for puppeteer, with more functionality and rewrited to work well with playwight.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published