@letsscrapedata/controller 0.0.53 → 0.0.55

package/dist/index.cjs

@@ -124,6 +124,9 @@ var PlaywrightElement = class _PlaywrightElement {
     const names = await this.#locator.evaluate((node) => node.getAttributeNames());
     return names;
   }
+  async boundingBox() {
+    return await this.#locator.boundingBox();
+  }
   async dataset() {
     try {
       const dataset = await this.#locator.evaluate((node) => node.dataset);
@@ -899,6 +902,41 @@ var PlaywrightPage = class extends import_node_events.default {
     const width = await this.pageWidth();
     return await this.setViewportSize({ height, width });
   }
+  async mouseClick(x, y, options) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.click(x, y, options);
+    return true;
+  }
+  async mouseDown() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.down();
+    return true;
+  }
+  async mouseMove(x, y) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.move(x, y);
+    return true;
+  }
+  async mouseUp() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.up();
+    return true;
+  }
+  async mouseWheel(deltaX = 0, deltaY = 0) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.wheel(deltaX, deltaY);
+    return true;
+  }
   async pageHeight() {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -931,6 +969,18 @@ var PlaywrightPage = class extends import_node_events.default {
     const buffer = await this.#page.pdf(options);
     return buffer;
   }
+  async reload() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    try {
+      await this.#page.reload();
+      return true;
+    } catch (err) {
+      loginfo(err);
+      return false;
+    }
+  }
   async screenshot(options) {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -1875,6 +1925,9 @@ var PuppeteerElement = class _PuppeteerElement {
     const names = await this.#frame.evaluate((ele) => ele.getAttributeNames(), this.#$ele);
     return names;
   }
+  async boundingBox() {
+    return await this.#$ele.boundingBox();
+  }
   async dataset() {
     try {
       const attributeNames = await this.attributeNames();
@@ -2619,6 +2672,41 @@ var PuppeteerPage = class extends import_node_events4.default {
     const width = await this.pageWidth();
     return await this.setViewportSize({ height, width });
   }
+  async mouseClick(x, y, options) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.click(x, y, options);
+    return true;
+  }
+  async mouseDown() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.down();
+    return true;
+  }
+  async mouseMove(x, y) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.move(x, y);
+    return true;
+  }
+  async mouseUp() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.up();
+    return true;
+  }
+  async mouseWheel(deltaX = 0, deltaY = 0) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.wheel({ deltaX, deltaY });
+    return true;
+  }
   async pageHeight() {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -2651,6 +2739,18 @@ var PuppeteerPage = class extends import_node_events4.default {
     const buffer = await this.#page.pdf(options);
     return buffer;
   }
+  async reload() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    try {
+      await this.#page.reload();
+      return true;
+    } catch (err) {
+      loginfo(err);
+      return false;
+    }
+  }
   async screenshot(options) {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -3632,6 +3732,9 @@ var CheerioElement = class _CheerioElement {
     const text = this.#node.text();
     return text ? text : "";
   }
+  boundingBox() {
+    throw new Error("Not supported in CheerioElement.");
+  }
   async click() {
     throw new Error("Not supported in CheerioElement.");
   }
@@ -3801,6 +3904,21 @@ var CheerioPage = class extends import_node_events7.default {
   async maximizeViewport() {
     throw new Error("Not supported in CheerioPage.");
   }
+  async mouseClick() {
+    throw new Error("Not supported in CheerioPage.");
+  }
+  async mouseDown() {
+    throw new Error("Not supported in CheerioPage.");
+  }
+  async mouseMove() {
+    throw new Error("Not supported in CheerioPage.");
+  }
+  async mouseUp() {
+    throw new Error("Not supported in CheerioPage.");
+  }
+  async mouseWheel() {
+    throw new Error("Not supported in CheerioPage.");
+  }
   async pageHeight() {
     throw new Error("Not supported in CheerioPage.");
   }
@@ -3813,6 +3931,9 @@ var CheerioPage = class extends import_node_events7.default {
   async pdf() {
     throw new Error("Not supported in CheerioPage.");
   }
+  async reload() {
+    throw new Error("Not supported in CheerioPage.");
+  }
   async screenshot() {
     throw new Error("Not supported in CheerioPage.");
   }
@@ -3919,6 +4040,9 @@ var PatchrightElement = class _PatchrightElement {
     const names = await this.#locator.evaluate((node) => node.getAttributeNames());
     return names;
   }
+  async boundingBox() {
+    return await this.#locator.boundingBox();
+  }
   async dataset() {
     try {
       const dataset = await this.#locator.evaluate((node) => node.dataset);
@@ -4694,6 +4818,41 @@ var PatchrightPage = class extends import_node_events8.default {
     const width = await this.pageWidth();
     return await this.setViewportSize({ height, width });
   }
+  async mouseClick(x, y, options) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.click(x, y, options);
+    return true;
+  }
+  async mouseDown() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.down();
+    return true;
+  }
+  async mouseMove(x, y) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.move(x, y);
+    return true;
+  }
+  async mouseUp() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.up();
+    return true;
+  }
+  async mouseWheel(deltaX = 0, deltaY = 0) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.wheel(deltaX, deltaY);
+    return true;
+  }
   async pageHeight() {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -4726,6 +4885,18 @@ var PatchrightPage = class extends import_node_events8.default {
     const buffer = await this.#page.pdf(options);
     return buffer;
   }
+  async reload() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    try {
+      await this.#page.reload();
+      return true;
+    } catch (err) {
+      loginfo(err);
+      return false;
+    }
+  }
   async screenshot(options) {
     if (!this.#page) {
       throw new Error("No valid page");

package/dist/index.d.cts

@@ -372,6 +372,24 @@ interface MouseClickOptions {
      */
     clickType?: MouseClickType;
 }
+interface PageMouseClickOptions {
+    /**
+     * Which button will be pressed.
+     * @default left
+     */
+    button?: "left" | "right" | "middle";
+    /**
+     * Number of clicks to perform.
+     * * puppeteer: count (clickCount deprecated)
+     * @default 1
+     */
+    clickCount?: 1 | 2 | 3;
+    /**
+     * Time to wait between mousedown and mouseup in milliseconds.
+     * @default 0
+     */
+    delay?: number;
+}
 interface SelectOptions {
     /**
      * Which attribute of select option to match
@@ -455,6 +473,15 @@ interface LsdElement {
      * @returns the attribute names of the element
      */
     attributeNames(): Promise<string[]>;
+    /**
+     * This method returns the bounding box of the element (relative to the main frame), or null if the element is not part of the layout (example: display: none).
+     */
+    boundingBox(): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
     dataset(): Promise<Record<string, string>>;
     /**
      * In order to be compatible with various browser controllers, if you need to use this function, please follow the following conventions:
@@ -853,7 +880,7 @@ interface ScreenshotOptions {
      */
     path?: string;
     /**
-     * @defaultValue `'png'`
+     * @defaultValue `'png'
      */
     type?: 'png' | 'jpeg';
 }
@@ -991,10 +1018,16 @@ interface LsdPage extends EventEmitter {
     localStroage(): Promise<LocalStorageOrigin[]>;
     mainFrame(): AllFrame;
     maximizeViewport(): Promise<boolean>;
+    mouseClick(x: number, y: number, options?: PageMouseClickOptions): Promise<boolean>;
+    mouseDown(): Promise<boolean>;
+    mouseMove(x: number, y: number): Promise<boolean>;
+    mouseUp(): Promise<boolean>;
+    mouseWheel(deltaX?: number, delterY?: number): Promise<boolean>;
     pageHeight(): Promise<number>;
     pageInfo(): PageInfo;
     pageWidth(): Promise<number>;
     pdf(options?: PDFOptions): Promise<Buffer>;
+    reload(): Promise<boolean>;
     screenshot(options?: ScreenshotOptions): Promise<Buffer>;
     scrollBy(x: number, y: number): Promise<boolean>;
     scrollTo(x: number, y: number): Promise<boolean>;
@@ -1284,10 +1317,16 @@ declare class PlaywrightPage extends EventEmitter implements LsdPage {
     load(): boolean;
     mainFrame(): AllFrame;
     maximizeViewport(): Promise<boolean>;
+    mouseClick(x: number, y: number, options?: PageMouseClickOptions): Promise<boolean>;
+    mouseDown(): Promise<boolean>;
+    mouseMove(x: number, y: number): Promise<boolean>;
+    mouseUp(): Promise<boolean>;
+    mouseWheel(deltaX?: number, deltaY?: number): Promise<boolean>;
     pageHeight(): Promise<number>;
     pageInfo(): PageInfo;
     pageWidth(): Promise<number>;
     pdf(options?: PDFOptions | undefined): Promise<Buffer>;
+    reload(): Promise<boolean>;
     screenshot(options?: ScreenshotOptions): Promise<Buffer>;
     scrollBy(x: number, y: number): Promise<boolean>;
     scrollTo(x: number, y: number): Promise<boolean>;
@@ -1318,6 +1357,12 @@ declare class PlaywrightElement implements LsdElement {
     constructor(locator: Locator, frame: Frame | FrameLocator);
     attribute(attributeName: string): Promise<string>;
     attributeNames(): Promise<string[]>;
+    boundingBox(): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
     dataset(): Promise<Record<string, string>>;
     evaluate(func: Function, args?: any[]): Promise<any>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement | null>;
@@ -1420,10 +1465,16 @@ declare class PuppeteerPage extends EventEmitter implements LsdPage {
     load(): boolean;
     mainFrame(): AllFrame;
     maximizeViewport(): Promise<boolean>;
+    mouseClick(x: number, y: number, options?: PageMouseClickOptions): Promise<boolean>;
+    mouseDown(): Promise<boolean>;
+    mouseMove(x: number, y: number): Promise<boolean>;
+    mouseUp(): Promise<boolean>;
+    mouseWheel(deltaX?: number, deltaY?: number): Promise<boolean>;
     pageHeight(): Promise<number>;
     pageInfo(): PageInfo;
     pageWidth(): Promise<number>;
     pdf(options?: PDFOptions | undefined): Promise<Buffer>;
+    reload(): Promise<boolean>;
     screenshot(options?: ScreenshotOptions): Promise<Buffer>;
     scrollBy(x: number, y: number): Promise<boolean>;
     scrollTo(x: number, y: number): Promise<boolean>;
@@ -1454,6 +1505,12 @@ declare class PuppeteerElement implements LsdElement {
     constructor($ele: ElementHandle, frame: Frame$1);
     attribute(attributeName: string): Promise<string>;
     attributeNames(): Promise<string[]>;
+    boundingBox(): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
     dataset(): Promise<Record<string, string>>;
     evaluate(func: Function, args?: any[]): Promise<any>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement | null>;
@@ -1513,10 +1570,16 @@ declare class CheerioPage extends EventEmitter implements LsdPage {
     localStroage(): Promise<LocalStorageOrigin[]>;
     mainFrame(): AllFrame;
     maximizeViewport(): Promise<boolean>;
+    mouseClick(): Promise<boolean>;
+    mouseDown(): Promise<boolean>;
+    mouseMove(): Promise<boolean>;
+    mouseUp(): Promise<boolean>;
+    mouseWheel(): Promise<boolean>;
     pageHeight(): Promise<number>;
     pageInfo(): PageInfo;
     pageWidth(): Promise<number>;
     pdf(): Promise<Buffer>;
+    reload(): Promise<boolean>;
     screenshot(): Promise<Buffer>;
     scrollBy(): Promise<boolean>;
     scrollTo(): Promise<boolean>;
@@ -1555,6 +1618,12 @@ declare class CheerioElement implements LsdElement {
     innerText(): Promise<string>;
     outerHtml(): Promise<string>;
     textContent(): Promise<string>;
+    boundingBox(): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
     click(): Promise<boolean>;
     focus(): Promise<boolean>;
     hover(): Promise<boolean>;
@@ -1577,4 +1646,4 @@ declare class LsdBrowserController implements LsdBrowserController$1 {
 }
 declare const controller: LsdBrowserController;
 
-export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllElement, type AllElementHandle, type AllFrame, type AllPage, type AllResponse, type BrowserContextCreationMethod, type BrowserContextRequirements, type BrowserContextStatus, type BrowserControllerType, type BrowserCreationMethod, type BrowserLaunchMethod, type BrowserStateData, CheerioElement, type CheerioNode, CheerioPage, type ClientCertificate, type CookieItem, type FrameAddScriptTagOptions, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdApiContext, type LsdApiContextOptions, type LsdApiResponse, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdFetchOptions, type LsdLaunchOptions, type LsdPage, type MouseClickOptions, type MouseClickType, type NavigationWaitUntil, type PDFMargin, type PDFOptions, type PageEvent, type PageExtInPatchright, type PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, type PatchrightBrowserTypes, PlaywrightBrowser, PlaywrightBrowserContext, type PlaywrightBrowserTypes, PlaywrightElement, PlaywrightPage, type ProxyInController, PuppeteerBrowser, PuppeteerBrowserContext, PuppeteerElement, PuppeteerPage, type RequestInterceptionAction, type RequestInterceptionOption, type RequestMatch, type RequestMethod, type RequestResourceType, type ResponseHandler, type ResponseHandlerOptions, type ResponseInterceptionItem, type ResponseInterceptionOption, type ResponseMatch, type ResponsePageData, type ScreenshotOptions, type SelectOptions, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller, setControllerLogFun };
+export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllElement, type AllElementHandle, type AllFrame, type AllPage, type AllResponse, type BrowserContextCreationMethod, type BrowserContextRequirements, type BrowserContextStatus, type BrowserControllerType, type BrowserCreationMethod, type BrowserLaunchMethod, type BrowserStateData, CheerioElement, type CheerioNode, CheerioPage, type ClientCertificate, type CookieItem, type FrameAddScriptTagOptions, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdApiContext, type LsdApiContextOptions, type LsdApiResponse, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdFetchOptions, type LsdLaunchOptions, type LsdPage, type MouseClickOptions, type MouseClickType, type NavigationWaitUntil, type PDFMargin, type PDFOptions, type PageEvent, type PageExtInPatchright, type PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageMouseClickOptions, type PageOpenType, type PageStatus, type PaperFormat, type PatchrightBrowserTypes, PlaywrightBrowser, PlaywrightBrowserContext, type PlaywrightBrowserTypes, PlaywrightElement, PlaywrightPage, type ProxyInController, PuppeteerBrowser, PuppeteerBrowserContext, PuppeteerElement, PuppeteerPage, type RequestInterceptionAction, type RequestInterceptionOption, type RequestMatch, type RequestMethod, type RequestResourceType, type ResponseHandler, type ResponseHandlerOptions, type ResponseInterceptionItem, type ResponseInterceptionOption, type ResponseMatch, type ResponsePageData, type ScreenshotOptions, type SelectOptions, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller, setControllerLogFun };

package/dist/index.d.ts

@@ -372,6 +372,24 @@ interface MouseClickOptions {
      */
     clickType?: MouseClickType;
 }
+interface PageMouseClickOptions {
+    /**
+     * Which button will be pressed.
+     * @default left
+     */
+    button?: "left" | "right" | "middle";
+    /**
+     * Number of clicks to perform.
+     * * puppeteer: count (clickCount deprecated)
+     * @default 1
+     */
+    clickCount?: 1 | 2 | 3;
+    /**
+     * Time to wait between mousedown and mouseup in milliseconds.
+     * @default 0
+     */
+    delay?: number;
+}
 interface SelectOptions {
     /**
      * Which attribute of select option to match
@@ -455,6 +473,15 @@ interface LsdElement {
      * @returns the attribute names of the element
      */
     attributeNames(): Promise<string[]>;
+    /**
+     * This method returns the bounding box of the element (relative to the main frame), or null if the element is not part of the layout (example: display: none).
+     */
+    boundingBox(): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
     dataset(): Promise<Record<string, string>>;
     /**
      * In order to be compatible with various browser controllers, if you need to use this function, please follow the following conventions:
@@ -853,7 +880,7 @@ interface ScreenshotOptions {
      */
     path?: string;
     /**
-     * @defaultValue `'png'`
+     * @defaultValue `'png'
      */
     type?: 'png' | 'jpeg';
 }
@@ -991,10 +1018,16 @@ interface LsdPage extends EventEmitter {
     localStroage(): Promise<LocalStorageOrigin[]>;
     mainFrame(): AllFrame;
     maximizeViewport(): Promise<boolean>;
+    mouseClick(x: number, y: number, options?: PageMouseClickOptions): Promise<boolean>;
+    mouseDown(): Promise<boolean>;
+    mouseMove(x: number, y: number): Promise<boolean>;
+    mouseUp(): Promise<boolean>;
+    mouseWheel(deltaX?: number, delterY?: number): Promise<boolean>;
     pageHeight(): Promise<number>;
     pageInfo(): PageInfo;
     pageWidth(): Promise<number>;
     pdf(options?: PDFOptions): Promise<Buffer>;
+    reload(): Promise<boolean>;
     screenshot(options?: ScreenshotOptions): Promise<Buffer>;
     scrollBy(x: number, y: number): Promise<boolean>;
     scrollTo(x: number, y: number): Promise<boolean>;
@@ -1284,10 +1317,16 @@ declare class PlaywrightPage extends EventEmitter implements LsdPage {
     load(): boolean;
     mainFrame(): AllFrame;
     maximizeViewport(): Promise<boolean>;
+    mouseClick(x: number, y: number, options?: PageMouseClickOptions): Promise<boolean>;
+    mouseDown(): Promise<boolean>;
+    mouseMove(x: number, y: number): Promise<boolean>;
+    mouseUp(): Promise<boolean>;
+    mouseWheel(deltaX?: number, deltaY?: number): Promise<boolean>;
     pageHeight(): Promise<number>;
     pageInfo(): PageInfo;
     pageWidth(): Promise<number>;
     pdf(options?: PDFOptions | undefined): Promise<Buffer>;
+    reload(): Promise<boolean>;
     screenshot(options?: ScreenshotOptions): Promise<Buffer>;
     scrollBy(x: number, y: number): Promise<boolean>;
     scrollTo(x: number, y: number): Promise<boolean>;
@@ -1318,6 +1357,12 @@ declare class PlaywrightElement implements LsdElement {
     constructor(locator: Locator, frame: Frame | FrameLocator);
     attribute(attributeName: string): Promise<string>;
     attributeNames(): Promise<string[]>;
+    boundingBox(): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
     dataset(): Promise<Record<string, string>>;
     evaluate(func: Function, args?: any[]): Promise<any>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement | null>;
@@ -1420,10 +1465,16 @@ declare class PuppeteerPage extends EventEmitter implements LsdPage {
     load(): boolean;
     mainFrame(): AllFrame;
     maximizeViewport(): Promise<boolean>;
+    mouseClick(x: number, y: number, options?: PageMouseClickOptions): Promise<boolean>;
+    mouseDown(): Promise<boolean>;
+    mouseMove(x: number, y: number): Promise<boolean>;
+    mouseUp(): Promise<boolean>;
+    mouseWheel(deltaX?: number, deltaY?: number): Promise<boolean>;
     pageHeight(): Promise<number>;
     pageInfo(): PageInfo;
     pageWidth(): Promise<number>;
     pdf(options?: PDFOptions | undefined): Promise<Buffer>;
+    reload(): Promise<boolean>;
     screenshot(options?: ScreenshotOptions): Promise<Buffer>;
     scrollBy(x: number, y: number): Promise<boolean>;
     scrollTo(x: number, y: number): Promise<boolean>;
@@ -1454,6 +1505,12 @@ declare class PuppeteerElement implements LsdElement {
     constructor($ele: ElementHandle, frame: Frame$1);
     attribute(attributeName: string): Promise<string>;
     attributeNames(): Promise<string[]>;
+    boundingBox(): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
     dataset(): Promise<Record<string, string>>;
     evaluate(func: Function, args?: any[]): Promise<any>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement | null>;
@@ -1513,10 +1570,16 @@ declare class CheerioPage extends EventEmitter implements LsdPage {
     localStroage(): Promise<LocalStorageOrigin[]>;
     mainFrame(): AllFrame;
     maximizeViewport(): Promise<boolean>;
+    mouseClick(): Promise<boolean>;
+    mouseDown(): Promise<boolean>;
+    mouseMove(): Promise<boolean>;
+    mouseUp(): Promise<boolean>;
+    mouseWheel(): Promise<boolean>;
     pageHeight(): Promise<number>;
     pageInfo(): PageInfo;
     pageWidth(): Promise<number>;
     pdf(): Promise<Buffer>;
+    reload(): Promise<boolean>;
     screenshot(): Promise<Buffer>;
     scrollBy(): Promise<boolean>;
     scrollTo(): Promise<boolean>;
@@ -1555,6 +1618,12 @@ declare class CheerioElement implements LsdElement {
     innerText(): Promise<string>;
     outerHtml(): Promise<string>;
     textContent(): Promise<string>;
+    boundingBox(): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
     click(): Promise<boolean>;
     focus(): Promise<boolean>;
     hover(): Promise<boolean>;
@@ -1577,4 +1646,4 @@ declare class LsdBrowserController implements LsdBrowserController$1 {
 }
 declare const controller: LsdBrowserController;
 
-export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllElement, type AllElementHandle, type AllFrame, type AllPage, type AllResponse, type BrowserContextCreationMethod, type BrowserContextRequirements, type BrowserContextStatus, type BrowserControllerType, type BrowserCreationMethod, type BrowserLaunchMethod, type BrowserStateData, CheerioElement, type CheerioNode, CheerioPage, type ClientCertificate, type CookieItem, type FrameAddScriptTagOptions, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdApiContext, type LsdApiContextOptions, type LsdApiResponse, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdFetchOptions, type LsdLaunchOptions, type LsdPage, type MouseClickOptions, type MouseClickType, type NavigationWaitUntil, type PDFMargin, type PDFOptions, type PageEvent, type PageExtInPatchright, type PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, type PatchrightBrowserTypes, PlaywrightBrowser, PlaywrightBrowserContext, type PlaywrightBrowserTypes, PlaywrightElement, PlaywrightPage, type ProxyInController, PuppeteerBrowser, PuppeteerBrowserContext, PuppeteerElement, PuppeteerPage, type RequestInterceptionAction, type RequestInterceptionOption, type RequestMatch, type RequestMethod, type RequestResourceType, type ResponseHandler, type ResponseHandlerOptions, type ResponseInterceptionItem, type ResponseInterceptionOption, type ResponseMatch, type ResponsePageData, type ScreenshotOptions, type SelectOptions, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller, setControllerLogFun };
+export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllElement, type AllElementHandle, type AllFrame, type AllPage, type AllResponse, type BrowserContextCreationMethod, type BrowserContextRequirements, type BrowserContextStatus, type BrowserControllerType, type BrowserCreationMethod, type BrowserLaunchMethod, type BrowserStateData, CheerioElement, type CheerioNode, CheerioPage, type ClientCertificate, type CookieItem, type FrameAddScriptTagOptions, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdApiContext, type LsdApiContextOptions, type LsdApiResponse, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdFetchOptions, type LsdLaunchOptions, type LsdPage, type MouseClickOptions, type MouseClickType, type NavigationWaitUntil, type PDFMargin, type PDFOptions, type PageEvent, type PageExtInPatchright, type PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageMouseClickOptions, type PageOpenType, type PageStatus, type PaperFormat, type PatchrightBrowserTypes, PlaywrightBrowser, PlaywrightBrowserContext, type PlaywrightBrowserTypes, PlaywrightElement, PlaywrightPage, type ProxyInController, PuppeteerBrowser, PuppeteerBrowserContext, PuppeteerElement, PuppeteerPage, type RequestInterceptionAction, type RequestInterceptionOption, type RequestMatch, type RequestMethod, type RequestResourceType, type ResponseHandler, type ResponseHandlerOptions, type ResponseInterceptionItem, type ResponseInterceptionOption, type ResponseMatch, type ResponsePageData, type ScreenshotOptions, type SelectOptions, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller, setControllerLogFun };

package/dist/index.js

@@ -77,6 +77,9 @@ var PlaywrightElement = class _PlaywrightElement {
     const names = await this.#locator.evaluate((node) => node.getAttributeNames());
     return names;
   }
+  async boundingBox() {
+    return await this.#locator.boundingBox();
+  }
   async dataset() {
     try {
       const dataset = await this.#locator.evaluate((node) => node.dataset);
@@ -852,6 +855,41 @@ var PlaywrightPage = class extends EventEmitter {
     const width = await this.pageWidth();
     return await this.setViewportSize({ height, width });
   }
+  async mouseClick(x, y, options) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.click(x, y, options);
+    return true;
+  }
+  async mouseDown() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.down();
+    return true;
+  }
+  async mouseMove(x, y) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.move(x, y);
+    return true;
+  }
+  async mouseUp() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.up();
+    return true;
+  }
+  async mouseWheel(deltaX = 0, deltaY = 0) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.wheel(deltaX, deltaY);
+    return true;
+  }
   async pageHeight() {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -884,6 +922,18 @@ var PlaywrightPage = class extends EventEmitter {
     const buffer = await this.#page.pdf(options);
     return buffer;
   }
+  async reload() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    try {
+      await this.#page.reload();
+      return true;
+    } catch (err) {
+      loginfo(err);
+      return false;
+    }
+  }
   async screenshot(options) {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -1828,6 +1878,9 @@ var PuppeteerElement = class _PuppeteerElement {
     const names = await this.#frame.evaluate((ele) => ele.getAttributeNames(), this.#$ele);
     return names;
   }
+  async boundingBox() {
+    return await this.#$ele.boundingBox();
+  }
   async dataset() {
     try {
       const attributeNames = await this.attributeNames();
@@ -2572,6 +2625,41 @@ var PuppeteerPage = class extends EventEmitter4 {
     const width = await this.pageWidth();
     return await this.setViewportSize({ height, width });
   }
+  async mouseClick(x, y, options) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.click(x, y, options);
+    return true;
+  }
+  async mouseDown() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.down();
+    return true;
+  }
+  async mouseMove(x, y) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.move(x, y);
+    return true;
+  }
+  async mouseUp() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.up();
+    return true;
+  }
+  async mouseWheel(deltaX = 0, deltaY = 0) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.wheel({ deltaX, deltaY });
+    return true;
+  }
   async pageHeight() {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -2604,6 +2692,18 @@ var PuppeteerPage = class extends EventEmitter4 {
     const buffer = await this.#page.pdf(options);
     return buffer;
   }
+  async reload() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    try {
+      await this.#page.reload();
+      return true;
+    } catch (err) {
+      loginfo(err);
+      return false;
+    }
+  }
   async screenshot(options) {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -3585,6 +3685,9 @@ var CheerioElement = class _CheerioElement {
     const text = this.#node.text();
     return text ? text : "";
   }
+  boundingBox() {
+    throw new Error("Not supported in CheerioElement.");
+  }
   async click() {
     throw new Error("Not supported in CheerioElement.");
   }
@@ -3754,6 +3857,21 @@ var CheerioPage = class extends EventEmitter7 {
   async maximizeViewport() {
     throw new Error("Not supported in CheerioPage.");
   }
+  async mouseClick() {
+    throw new Error("Not supported in CheerioPage.");
+  }
+  async mouseDown() {
+    throw new Error("Not supported in CheerioPage.");
+  }
+  async mouseMove() {
+    throw new Error("Not supported in CheerioPage.");
+  }
+  async mouseUp() {
+    throw new Error("Not supported in CheerioPage.");
+  }
+  async mouseWheel() {
+    throw new Error("Not supported in CheerioPage.");
+  }
   async pageHeight() {
     throw new Error("Not supported in CheerioPage.");
   }
@@ -3766,6 +3884,9 @@ var CheerioPage = class extends EventEmitter7 {
   async pdf() {
     throw new Error("Not supported in CheerioPage.");
   }
+  async reload() {
+    throw new Error("Not supported in CheerioPage.");
+  }
   async screenshot() {
     throw new Error("Not supported in CheerioPage.");
   }
@@ -3872,6 +3993,9 @@ var PatchrightElement = class _PatchrightElement {
     const names = await this.#locator.evaluate((node) => node.getAttributeNames());
     return names;
   }
+  async boundingBox() {
+    return await this.#locator.boundingBox();
+  }
   async dataset() {
     try {
       const dataset = await this.#locator.evaluate((node) => node.dataset);
@@ -4647,6 +4771,41 @@ var PatchrightPage = class extends EventEmitter8 {
     const width = await this.pageWidth();
     return await this.setViewportSize({ height, width });
   }
+  async mouseClick(x, y, options) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.click(x, y, options);
+    return true;
+  }
+  async mouseDown() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.down();
+    return true;
+  }
+  async mouseMove(x, y) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.move(x, y);
+    return true;
+  }
+  async mouseUp() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.up();
+    return true;
+  }
+  async mouseWheel(deltaX = 0, deltaY = 0) {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    await this.#page.mouse.wheel(deltaX, deltaY);
+    return true;
+  }
   async pageHeight() {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -4679,6 +4838,18 @@ var PatchrightPage = class extends EventEmitter8 {
     const buffer = await this.#page.pdf(options);
     return buffer;
   }
+  async reload() {
+    if (!this.#page) {
+      throw new Error("No valid page");
+    }
+    try {
+      await this.#page.reload();
+      return true;
+    } catch (err) {
+      loginfo(err);
+      return false;
+    }
+  }
   async screenshot(options) {
     if (!this.#page) {
       throw new Error("No valid page");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letsscrapedata/controller",
-  "version": "0.0.53",
+  "version": "0.0.55",
   "description": "Unified browser / HTML controller interfaces that support playwright, puppeteer and cheerio",
   "type": "module",
   "main": "./dist/index.cjs",