@letsscrapedata/controller 0.0.50 → 0.0.52

package/dist/index.d.cts

@@ -1,16 +1,20 @@
 import EventEmitter from 'node:events';
-import { Browser as Browser$1, BrowserContext as BrowserContext$1, Frame as Frame$1, Page as Page$1, ElementHandle, HTTPResponse, PuppeteerNode } from 'puppeteer';
-import { Browser, BrowserContext, Frame, Page, Locator, Response, APIRequestContext, BrowserType, FrameLocator } from 'playwright';
+import { Browser as Browser$1, BrowserContext as BrowserContext$1, ElementHandle, Frame as Frame$1, Page as Page$1, HTTPResponse, PuppeteerNode } from 'puppeteer';
+import { Browser, BrowserContext, Locator, ElementHandle as ElementHandle$1, Frame, Page, Response, APIRequestContext, BrowserType, FrameLocator } from 'playwright';
+import { Serializable } from 'node:child_process';
+import { LogFunction } from '@letsscrapedata/utils';
+import { Serializable as Serializable$1 } from 'child_process';
 
+type BrowserControllerType = "puppeteer" | "playwright";
 type AllBrowser = Browser | Browser$1;
 type AllBrowserContext = BrowserContext | BrowserContext$1;
+type AllElement = Locator | ElementHandle;
+type AllElementHandle = ElementHandle$1 | ElementHandle;
 type AllFrame = Frame | Frame$1;
 type AllPage = Page | Page$1;
-type AllElement = Locator | ElementHandle;
 type AllResponse = Response | HTTPResponse;
 type AllApiRequestContext = APIRequestContext;
 type CheerioNode = cheerio.Cheerio;
-type BrowserControllerType = "puppeteer" | "playwright";
 type BrowserCreationMethod = "launch" | "connect";
 type BrowserContextCreationMethod = "launch" | "new";
 type BrowserContextStatus = "free" | "busy" | "closed";
@@ -296,6 +300,33 @@ interface PageExtInPuppeteer extends Page$1 {
 interface PageExtInPlaywright extends Page {
     pageInfo?: PageInfo;
 }
+interface FrameAddScriptTagOptions {
+    /**
+     * URL of the script to be added.
+     */
+    url?: string;
+    /**
+     * Path to a JavaScript file to be injected into the frame.
+     *
+     * @remarks
+     * If `path` is a relative path, it is resolved relative to the current
+     * working directory (`process.cwd()` in Node.js).
+     */
+    path?: string;
+    /**
+     * JavaScript to be injected into the frame.
+     */
+    content?: string;
+    /**
+     * Sets the `type` of the script. Use `module` in order to load an ES2015 module.
+     */
+    type?: string;
+    /**
+     * Sets the `id` of the script.
+     * * supported only in puppeteer
+     */
+    id?: string;
+}
 type MouseClickType = "click" | "evaluate";
 interface MouseClickOptions {
     /**
@@ -370,6 +401,10 @@ interface IframeOption {
      * * RegExp: iframe.src matches this RegExp
      */
     src?: string | RegExp;
+    /**
+     * id of iframe
+     */
+    id?: string;
     /**
      * CSS selector or XPath
      */
@@ -411,6 +446,17 @@ interface LsdElement {
      * @returns the attribute names of the element
      */
     attributeNames(): Promise<string[]>;
+    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:
+     * * If the element is in an iframe, use the descendant type when locating the iframe, not the child type!
+     * * * Reason: args of <page/frame | locator>.evaluate are different in Playwright
+     * * When there is only one parameter: element.evaluate(arg=>statements, val)
+     * * When there are one or more parameters: element.evaluate(([arg1, arg2]=>statements, [val1, val2])
+     * @param func
+     * @param args
+     */
+    evaluate(func: Function, args?: any[]): Promise<Serializable>;
     /**
      * @returns the first element matching the given CSS selector or XPath
      * @param selectorOrXpath CSS selector or XPath; if this parameter is an array, each selectorOrXpath in the array will be tried until elements are selected
@@ -830,6 +876,19 @@ interface WaitNavigationOptions {
 }
 type PageEvent = "pageClose" | "pagePopup";
 interface LsdPage extends EventEmitter {
+    /**
+     * Adds a script which would be evaluated in one of the following scenarios:
+     * * Whenever the page is navigated.
+     * * Whenever the child frame is attached or navigated. In this case, the script is evaluated in the context of the newly attached frame.
+     * @param scriptOrFunc
+     * @param arg
+     */
+    addPreloadScript(scriptOrFunc: string | Function, arg?: Serializable): Promise<boolean>;
+    /**
+     * Adds a `<script>` tag into the page with the desired URL or content.
+     * @param options
+     */
+    addScriptTag(options: FrameAddScriptTagOptions): Promise<AllElementHandle>;
     /**
      * Get the LsdApiContext associated with this page's LsdBrowserContext
      * * only vaild in playwright
@@ -865,19 +924,38 @@ interface LsdPage extends EventEmitter {
      * Only free page can be closed!
      */
     close(): Promise<boolean>;
+    /**
+     * Should the page be closed when it is freed?
+     * * Sometimes, in order to avoid being used again, you need to close the page.
+     * * valid only in browser page
+     * @default false, please call setCloseWhenFree to change it
+     */
+    closeWhenFree(): boolean;
     /**
      * Get the full HTML content of the page or decendant frame
      * @param iframeOptions default [], selectors of decendant frames
      */
     content(iframeOptions?: IframeOption[]): Promise<string>;
     cookies(): Promise<CookieItem[]>;
-    evalute(fun: Function, args?: any[]): Promise<any>;
+    evaluate(func: Function, args?: any[]): Promise<any>;
+    /**
+     * The method adds a function called `name` on the page's `window` object.
+     * When called, the function executes `callbackFunction` in node.js and
+     * returns a `Promise` which resolves to the return value of `callbackFunction`.
+     * * Reminder: It is not recommended to use this function because it is easy to be detected !!!
+     * @param name Name of the function on the window object
+     * @param callbackFunction Callback function which will be called in node.js context
+     */
+    exposeFunction(name: string, callbackFunction: Function): Promise<void>;
     /**
      * @returns the first element matching the given CSS selector or XPath
      * @param selectorOrXpath CSS selector or XPath; if this parameter is an array, each selectorOrXpath in the array will be tried until elements are selected
      * @param iframeOptions default [], options to select decendant frame
+     * @param iframeType default "child", "descendant" is valid only if selectorOrXpath is string , iframeOptions.length is 1 and iframeOptions[0].src is string or RegExp
+     * @example
+     * * findElement("body", [{src: iframe.src}], "descendant"): to get the body element of a descendant iframe with src
      */
-    findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[]): Promise<LsdElement | null>;
+    findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], iframeType?: "child" | "descendant"): Promise<LsdElement | null>;
     /**
      * @returns elements matching the given CSS selector or XPath
      * @param selectorOrXpath CSS selector or XPath; if this parameter is an array, each selectorOrXpath in the array will be tried until elements are selected
@@ -919,6 +997,12 @@ interface LsdPage extends EventEmitter {
      * @param detach default true, whether to detach the CDPSession from target
      */
     sendCDPMessage(method: string, params?: object | null, detach?: boolean): Promise<any>;
+    /**
+     * set new value of closeWhenFree, refer to closeWhenFree
+     * * valid only in browser page
+     * @param closeWhenFree
+     */
+    setCloseWhenFree(closeWhenFree: boolean): boolean;
     setCookies(cookies: CookieItem[]): Promise<boolean>;
     setExtraHTTPHeaders(headers: Record<string, string>): Promise<boolean>;
     /**
@@ -1108,6 +1192,8 @@ interface LsdBrowserController$1 {
     newApiContext(options?: LsdApiContextOptions): Promise<LsdApiContext>;
 }
 
+declare function setControllerLogFun(logFun: LogFunction): boolean;
+
 declare class PlaywrightBrowser extends EventEmitter implements LsdBrowser {
     #private;
     constructor(browser: Browser, browerType: LsdBrowserType, browserCreateMethod: BrowserCreationMethod, options: LsdLaunchOptions | LsdConnectOptions, browserIdx?: number, pid?: number);
@@ -1161,6 +1247,8 @@ declare class PlaywrightBrowserContext extends EventEmitter implements LsdBrowse
 declare class PlaywrightPage extends EventEmitter implements LsdPage {
     #private;
     constructor(browserContext: LsdBrowserContext, page: Page, pageInfo?: PageInfo);
+    addPreloadScript(scriptOrFunc: string | Function, arg?: Serializable$1): Promise<boolean>;
+    addScriptTag(options: FrameAddScriptTagOptions): Promise<AllElementHandle>;
     apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
@@ -1170,10 +1258,12 @@ declare class PlaywrightPage extends EventEmitter implements LsdPage {
     clearResponseInterceptions(): Promise<boolean>;
     clearStateData(): Promise<boolean>;
     close(): Promise<boolean>;
+    closeWhenFree(): boolean;
     content(iframeOptions?: IframeOption[]): Promise<string>;
     cookies(): Promise<CookieItem[]>;
     documentHeight(): Promise<number>;
-    evalute(fun: Function, args?: any[]): Promise<any>;
+    evaluate(func: Function, args?: any[]): Promise<any>;
+    exposeFunction(name: string, callbackFunction: Function): Promise<void>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[]): Promise<LsdElement | null>;
     findElements(selectorOrXpath: string | string[], iframeOptions?: IframeOption[]): Promise<LsdElement[]>;
     free(): Promise<boolean>;
@@ -1192,6 +1282,7 @@ declare class PlaywrightPage extends EventEmitter implements LsdPage {
     scrollBy(x: number, y: number): Promise<boolean>;
     scrollTo(x: number, y: number): Promise<boolean>;
     sendCDPMessage(method: string, params?: object | null, detach?: boolean): Promise<any>;
+    setCloseWhenFree(closeWhenFree: boolean): boolean;
     setCookies(cookies: CookieItem[]): Promise<boolean>;
     setExtraHTTPHeaders(headers: Record<string, string>): Promise<boolean>;
     setLocalStroage(localStorageItems: LocalStorageItem[]): Promise<boolean>;
@@ -1217,6 +1308,8 @@ declare class PlaywrightElement implements LsdElement {
     constructor(locator: Locator, frame: Frame | FrameLocator);
     attribute(attributeName: string): Promise<string>;
     attributeNames(): Promise<string[]>;
+    dataset(): Promise<Record<string, string>>;
+    evaluate(func: Function, args?: any[]): Promise<any>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement | null>;
     findElements(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement[]>;
     hasAttribute(attributeName: string): Promise<boolean>;
@@ -1289,6 +1382,8 @@ declare class PuppeteerBrowserContext extends EventEmitter implements LsdBrowser
 declare class PuppeteerPage extends EventEmitter implements LsdPage {
     #private;
     constructor(browserContext: LsdBrowserContext, page: Page$1, pageInfo?: PageInfo);
+    addPreloadScript(scriptOrFunc: string | Function, arg?: Serializable$1): Promise<boolean>;
+    addScriptTag(options: FrameAddScriptTagOptions): Promise<AllElementHandle>;
     apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
@@ -1298,10 +1393,12 @@ declare class PuppeteerPage extends EventEmitter implements LsdPage {
     clearResponseInterceptions(): Promise<boolean>;
     clearStateData(): Promise<boolean>;
     close(): Promise<boolean>;
+    closeWhenFree(): boolean;
     content(iframeOptions?: IframeOption[]): Promise<string>;
     cookies(): Promise<CookieItem[]>;
     documentHeight(): Promise<number>;
-    evalute(fun: Function, args?: any[]): Promise<any>;
+    evaluate(func: Function, args?: any[]): Promise<any>;
+    exposeFunction(name: string, callbackFunction: Function): Promise<void>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[]): Promise<LsdElement | null>;
     findElements(selectorOrXpath: string | string[], iframeOptions?: IframeOption[]): Promise<LsdElement[]>;
     free(): Promise<boolean>;
@@ -1320,6 +1417,7 @@ declare class PuppeteerPage extends EventEmitter implements LsdPage {
     scrollBy(x: number, y: number): Promise<boolean>;
     scrollTo(x: number, y: number): Promise<boolean>;
     sendCDPMessage(method: string, params?: object | null, detach?: boolean): Promise<any>;
+    setCloseWhenFree(closeWhenFree: boolean): boolean;
     setCookies(cookies: CookieItem[]): Promise<boolean>;
     setExtraHTTPHeaders(headers: Record<string, string>): Promise<boolean>;
     setLocalStroage(localStorageItems: LocalStorageItem[]): Promise<boolean>;
@@ -1345,6 +1443,8 @@ declare class PuppeteerElement implements LsdElement {
     constructor($ele: ElementHandle, frame: Frame$1);
     attribute(attributeName: string): Promise<string>;
     attributeNames(): Promise<string[]>;
+    dataset(): Promise<Record<string, string>>;
+    evaluate(func: Function, args?: any[]): Promise<any>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement | null>;
     findElements(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement[]>;
     hasAttribute(attributeName: string): Promise<boolean>;
@@ -1364,6 +1464,9 @@ declare class PuppeteerElement implements LsdElement {
     _origElement(): AllElement;
 }
 
+/**
+ * CheerioPage does not support iframe: https://github.com/cheeriojs/cheerio/issues/602
+ */
 declare class CheerioPage extends EventEmitter implements LsdPage {
     #private;
     /**
@@ -1373,6 +1476,8 @@ declare class CheerioPage extends EventEmitter implements LsdPage {
      */
     constructor(html?: string, isHtml?: boolean);
     _origPage(): AllPage;
+    addPreloadScript(): Promise<boolean>;
+    addScriptTag(): Promise<AllElementHandle>;
     apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
@@ -1382,9 +1487,11 @@ declare class CheerioPage extends EventEmitter implements LsdPage {
     clearResponseInterceptions(): Promise<boolean>;
     clearStateData(): Promise<boolean>;
     close(): Promise<boolean>;
+    closeWhenFree(): boolean;
     content(): Promise<string>;
     cookies(): Promise<CookieItem[]>;
-    evalute(): Promise<any>;
+    evaluate(): Promise<any>;
+    exposeFunction(): Promise<void>;
     findElement(selectorOrXpath: string | string[]): Promise<LsdElement | null>;
     findElements(selectorOrXpath: string | string[]): Promise<LsdElement[]>;
     free(): Promise<boolean>;
@@ -1403,6 +1510,7 @@ declare class CheerioPage extends EventEmitter implements LsdPage {
     scrollBy(): Promise<boolean>;
     scrollTo(): Promise<boolean>;
     sendCDPMessage(): Promise<any>;
+    setCloseWhenFree(): boolean;
     setCookies(): Promise<boolean>;
     setExtraHTTPHeaders(): Promise<boolean>;
     setLocalStroage(): Promise<boolean>;
@@ -1427,6 +1535,8 @@ declare class CheerioElement implements LsdElement {
     constructor(node: CheerioNode);
     attribute(attributeName: string): Promise<string>;
     attributeNames(): Promise<string[]>;
+    dataset(): Promise<Record<string, string>>;
+    evaluate(): Promise<any>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement | null>;
     findElements(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement[]>;
     hasAttribute(attributeName: string): Promise<boolean>;
@@ -1457,4 +1567,4 @@ declare class LsdBrowserController implements LsdBrowserController$1 {
 }
 declare const controller: LsdBrowserController;
 
-export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllElement, 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 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 PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, 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 };
+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 PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, 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

@@ -1,16 +1,20 @@
 import EventEmitter from 'node:events';
-import { Browser as Browser$1, BrowserContext as BrowserContext$1, Frame as Frame$1, Page as Page$1, ElementHandle, HTTPResponse, PuppeteerNode } from 'puppeteer';
-import { Browser, BrowserContext, Frame, Page, Locator, Response, APIRequestContext, BrowserType, FrameLocator } from 'playwright';
+import { Browser as Browser$1, BrowserContext as BrowserContext$1, ElementHandle, Frame as Frame$1, Page as Page$1, HTTPResponse, PuppeteerNode } from 'puppeteer';
+import { Browser, BrowserContext, Locator, ElementHandle as ElementHandle$1, Frame, Page, Response, APIRequestContext, BrowserType, FrameLocator } from 'playwright';
+import { Serializable } from 'node:child_process';
+import { LogFunction } from '@letsscrapedata/utils';
+import { Serializable as Serializable$1 } from 'child_process';
 
+type BrowserControllerType = "puppeteer" | "playwright";
 type AllBrowser = Browser | Browser$1;
 type AllBrowserContext = BrowserContext | BrowserContext$1;
+type AllElement = Locator | ElementHandle;
+type AllElementHandle = ElementHandle$1 | ElementHandle;
 type AllFrame = Frame | Frame$1;
 type AllPage = Page | Page$1;
-type AllElement = Locator | ElementHandle;
 type AllResponse = Response | HTTPResponse;
 type AllApiRequestContext = APIRequestContext;
 type CheerioNode = cheerio.Cheerio;
-type BrowserControllerType = "puppeteer" | "playwright";
 type BrowserCreationMethod = "launch" | "connect";
 type BrowserContextCreationMethod = "launch" | "new";
 type BrowserContextStatus = "free" | "busy" | "closed";
@@ -296,6 +300,33 @@ interface PageExtInPuppeteer extends Page$1 {
 interface PageExtInPlaywright extends Page {
     pageInfo?: PageInfo;
 }
+interface FrameAddScriptTagOptions {
+    /**
+     * URL of the script to be added.
+     */
+    url?: string;
+    /**
+     * Path to a JavaScript file to be injected into the frame.
+     *
+     * @remarks
+     * If `path` is a relative path, it is resolved relative to the current
+     * working directory (`process.cwd()` in Node.js).
+     */
+    path?: string;
+    /**
+     * JavaScript to be injected into the frame.
+     */
+    content?: string;
+    /**
+     * Sets the `type` of the script. Use `module` in order to load an ES2015 module.
+     */
+    type?: string;
+    /**
+     * Sets the `id` of the script.
+     * * supported only in puppeteer
+     */
+    id?: string;
+}
 type MouseClickType = "click" | "evaluate";
 interface MouseClickOptions {
     /**
@@ -370,6 +401,10 @@ interface IframeOption {
      * * RegExp: iframe.src matches this RegExp
      */
     src?: string | RegExp;
+    /**
+     * id of iframe
+     */
+    id?: string;
     /**
      * CSS selector or XPath
      */
@@ -411,6 +446,17 @@ interface LsdElement {
      * @returns the attribute names of the element
      */
     attributeNames(): Promise<string[]>;
+    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:
+     * * If the element is in an iframe, use the descendant type when locating the iframe, not the child type!
+     * * * Reason: args of <page/frame | locator>.evaluate are different in Playwright
+     * * When there is only one parameter: element.evaluate(arg=>statements, val)
+     * * When there are one or more parameters: element.evaluate(([arg1, arg2]=>statements, [val1, val2])
+     * @param func
+     * @param args
+     */
+    evaluate(func: Function, args?: any[]): Promise<Serializable>;
     /**
      * @returns the first element matching the given CSS selector or XPath
      * @param selectorOrXpath CSS selector or XPath; if this parameter is an array, each selectorOrXpath in the array will be tried until elements are selected
@@ -830,6 +876,19 @@ interface WaitNavigationOptions {
 }
 type PageEvent = "pageClose" | "pagePopup";
 interface LsdPage extends EventEmitter {
+    /**
+     * Adds a script which would be evaluated in one of the following scenarios:
+     * * Whenever the page is navigated.
+     * * Whenever the child frame is attached or navigated. In this case, the script is evaluated in the context of the newly attached frame.
+     * @param scriptOrFunc
+     * @param arg
+     */
+    addPreloadScript(scriptOrFunc: string | Function, arg?: Serializable): Promise<boolean>;
+    /**
+     * Adds a `<script>` tag into the page with the desired URL or content.
+     * @param options
+     */
+    addScriptTag(options: FrameAddScriptTagOptions): Promise<AllElementHandle>;
     /**
      * Get the LsdApiContext associated with this page's LsdBrowserContext
      * * only vaild in playwright
@@ -865,19 +924,38 @@ interface LsdPage extends EventEmitter {
      * Only free page can be closed!
      */
     close(): Promise<boolean>;
+    /**
+     * Should the page be closed when it is freed?
+     * * Sometimes, in order to avoid being used again, you need to close the page.
+     * * valid only in browser page
+     * @default false, please call setCloseWhenFree to change it
+     */
+    closeWhenFree(): boolean;
     /**
      * Get the full HTML content of the page or decendant frame
      * @param iframeOptions default [], selectors of decendant frames
      */
     content(iframeOptions?: IframeOption[]): Promise<string>;
     cookies(): Promise<CookieItem[]>;
-    evalute(fun: Function, args?: any[]): Promise<any>;
+    evaluate(func: Function, args?: any[]): Promise<any>;
+    /**
+     * The method adds a function called `name` on the page's `window` object.
+     * When called, the function executes `callbackFunction` in node.js and
+     * returns a `Promise` which resolves to the return value of `callbackFunction`.
+     * * Reminder: It is not recommended to use this function because it is easy to be detected !!!
+     * @param name Name of the function on the window object
+     * @param callbackFunction Callback function which will be called in node.js context
+     */
+    exposeFunction(name: string, callbackFunction: Function): Promise<void>;
     /**
      * @returns the first element matching the given CSS selector or XPath
      * @param selectorOrXpath CSS selector or XPath; if this parameter is an array, each selectorOrXpath in the array will be tried until elements are selected
      * @param iframeOptions default [], options to select decendant frame
+     * @param iframeType default "child", "descendant" is valid only if selectorOrXpath is string , iframeOptions.length is 1 and iframeOptions[0].src is string or RegExp
+     * @example
+     * * findElement("body", [{src: iframe.src}], "descendant"): to get the body element of a descendant iframe with src
      */
-    findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[]): Promise<LsdElement | null>;
+    findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], iframeType?: "child" | "descendant"): Promise<LsdElement | null>;
     /**
      * @returns elements matching the given CSS selector or XPath
      * @param selectorOrXpath CSS selector or XPath; if this parameter is an array, each selectorOrXpath in the array will be tried until elements are selected
@@ -919,6 +997,12 @@ interface LsdPage extends EventEmitter {
      * @param detach default true, whether to detach the CDPSession from target
      */
     sendCDPMessage(method: string, params?: object | null, detach?: boolean): Promise<any>;
+    /**
+     * set new value of closeWhenFree, refer to closeWhenFree
+     * * valid only in browser page
+     * @param closeWhenFree
+     */
+    setCloseWhenFree(closeWhenFree: boolean): boolean;
     setCookies(cookies: CookieItem[]): Promise<boolean>;
     setExtraHTTPHeaders(headers: Record<string, string>): Promise<boolean>;
     /**
@@ -1108,6 +1192,8 @@ interface LsdBrowserController$1 {
     newApiContext(options?: LsdApiContextOptions): Promise<LsdApiContext>;
 }
 
+declare function setControllerLogFun(logFun: LogFunction): boolean;
+
 declare class PlaywrightBrowser extends EventEmitter implements LsdBrowser {
     #private;
     constructor(browser: Browser, browerType: LsdBrowserType, browserCreateMethod: BrowserCreationMethod, options: LsdLaunchOptions | LsdConnectOptions, browserIdx?: number, pid?: number);
@@ -1161,6 +1247,8 @@ declare class PlaywrightBrowserContext extends EventEmitter implements LsdBrowse
 declare class PlaywrightPage extends EventEmitter implements LsdPage {
     #private;
     constructor(browserContext: LsdBrowserContext, page: Page, pageInfo?: PageInfo);
+    addPreloadScript(scriptOrFunc: string | Function, arg?: Serializable$1): Promise<boolean>;
+    addScriptTag(options: FrameAddScriptTagOptions): Promise<AllElementHandle>;
     apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
@@ -1170,10 +1258,12 @@ declare class PlaywrightPage extends EventEmitter implements LsdPage {
     clearResponseInterceptions(): Promise<boolean>;
     clearStateData(): Promise<boolean>;
     close(): Promise<boolean>;
+    closeWhenFree(): boolean;
     content(iframeOptions?: IframeOption[]): Promise<string>;
     cookies(): Promise<CookieItem[]>;
     documentHeight(): Promise<number>;
-    evalute(fun: Function, args?: any[]): Promise<any>;
+    evaluate(func: Function, args?: any[]): Promise<any>;
+    exposeFunction(name: string, callbackFunction: Function): Promise<void>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[]): Promise<LsdElement | null>;
     findElements(selectorOrXpath: string | string[], iframeOptions?: IframeOption[]): Promise<LsdElement[]>;
     free(): Promise<boolean>;
@@ -1192,6 +1282,7 @@ declare class PlaywrightPage extends EventEmitter implements LsdPage {
     scrollBy(x: number, y: number): Promise<boolean>;
     scrollTo(x: number, y: number): Promise<boolean>;
     sendCDPMessage(method: string, params?: object | null, detach?: boolean): Promise<any>;
+    setCloseWhenFree(closeWhenFree: boolean): boolean;
     setCookies(cookies: CookieItem[]): Promise<boolean>;
     setExtraHTTPHeaders(headers: Record<string, string>): Promise<boolean>;
     setLocalStroage(localStorageItems: LocalStorageItem[]): Promise<boolean>;
@@ -1217,6 +1308,8 @@ declare class PlaywrightElement implements LsdElement {
     constructor(locator: Locator, frame: Frame | FrameLocator);
     attribute(attributeName: string): Promise<string>;
     attributeNames(): Promise<string[]>;
+    dataset(): Promise<Record<string, string>>;
+    evaluate(func: Function, args?: any[]): Promise<any>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement | null>;
     findElements(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement[]>;
     hasAttribute(attributeName: string): Promise<boolean>;
@@ -1289,6 +1382,8 @@ declare class PuppeteerBrowserContext extends EventEmitter implements LsdBrowser
 declare class PuppeteerPage extends EventEmitter implements LsdPage {
     #private;
     constructor(browserContext: LsdBrowserContext, page: Page$1, pageInfo?: PageInfo);
+    addPreloadScript(scriptOrFunc: string | Function, arg?: Serializable$1): Promise<boolean>;
+    addScriptTag(options: FrameAddScriptTagOptions): Promise<AllElementHandle>;
     apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
@@ -1298,10 +1393,12 @@ declare class PuppeteerPage extends EventEmitter implements LsdPage {
     clearResponseInterceptions(): Promise<boolean>;
     clearStateData(): Promise<boolean>;
     close(): Promise<boolean>;
+    closeWhenFree(): boolean;
     content(iframeOptions?: IframeOption[]): Promise<string>;
     cookies(): Promise<CookieItem[]>;
     documentHeight(): Promise<number>;
-    evalute(fun: Function, args?: any[]): Promise<any>;
+    evaluate(func: Function, args?: any[]): Promise<any>;
+    exposeFunction(name: string, callbackFunction: Function): Promise<void>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[]): Promise<LsdElement | null>;
     findElements(selectorOrXpath: string | string[], iframeOptions?: IframeOption[]): Promise<LsdElement[]>;
     free(): Promise<boolean>;
@@ -1320,6 +1417,7 @@ declare class PuppeteerPage extends EventEmitter implements LsdPage {
     scrollBy(x: number, y: number): Promise<boolean>;
     scrollTo(x: number, y: number): Promise<boolean>;
     sendCDPMessage(method: string, params?: object | null, detach?: boolean): Promise<any>;
+    setCloseWhenFree(closeWhenFree: boolean): boolean;
     setCookies(cookies: CookieItem[]): Promise<boolean>;
     setExtraHTTPHeaders(headers: Record<string, string>): Promise<boolean>;
     setLocalStroage(localStorageItems: LocalStorageItem[]): Promise<boolean>;
@@ -1345,6 +1443,8 @@ declare class PuppeteerElement implements LsdElement {
     constructor($ele: ElementHandle, frame: Frame$1);
     attribute(attributeName: string): Promise<string>;
     attributeNames(): Promise<string[]>;
+    dataset(): Promise<Record<string, string>>;
+    evaluate(func: Function, args?: any[]): Promise<any>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement | null>;
     findElements(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement[]>;
     hasAttribute(attributeName: string): Promise<boolean>;
@@ -1364,6 +1464,9 @@ declare class PuppeteerElement implements LsdElement {
     _origElement(): AllElement;
 }
 
+/**
+ * CheerioPage does not support iframe: https://github.com/cheeriojs/cheerio/issues/602
+ */
 declare class CheerioPage extends EventEmitter implements LsdPage {
     #private;
     /**
@@ -1373,6 +1476,8 @@ declare class CheerioPage extends EventEmitter implements LsdPage {
      */
     constructor(html?: string, isHtml?: boolean);
     _origPage(): AllPage;
+    addPreloadScript(): Promise<boolean>;
+    addScriptTag(): Promise<AllElementHandle>;
     apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
@@ -1382,9 +1487,11 @@ declare class CheerioPage extends EventEmitter implements LsdPage {
     clearResponseInterceptions(): Promise<boolean>;
     clearStateData(): Promise<boolean>;
     close(): Promise<boolean>;
+    closeWhenFree(): boolean;
     content(): Promise<string>;
     cookies(): Promise<CookieItem[]>;
-    evalute(): Promise<any>;
+    evaluate(): Promise<any>;
+    exposeFunction(): Promise<void>;
     findElement(selectorOrXpath: string | string[]): Promise<LsdElement | null>;
     findElements(selectorOrXpath: string | string[]): Promise<LsdElement[]>;
     free(): Promise<boolean>;
@@ -1403,6 +1510,7 @@ declare class CheerioPage extends EventEmitter implements LsdPage {
     scrollBy(): Promise<boolean>;
     scrollTo(): Promise<boolean>;
     sendCDPMessage(): Promise<any>;
+    setCloseWhenFree(): boolean;
     setCookies(): Promise<boolean>;
     setExtraHTTPHeaders(): Promise<boolean>;
     setLocalStroage(): Promise<boolean>;
@@ -1427,6 +1535,8 @@ declare class CheerioElement implements LsdElement {
     constructor(node: CheerioNode);
     attribute(attributeName: string): Promise<string>;
     attributeNames(): Promise<string[]>;
+    dataset(): Promise<Record<string, string>>;
+    evaluate(): Promise<any>;
     findElement(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement | null>;
     findElements(selectorOrXpath: string | string[], iframeOptions?: IframeOption[], absolute?: boolean): Promise<LsdElement[]>;
     hasAttribute(attributeName: string): Promise<boolean>;
@@ -1457,4 +1567,4 @@ declare class LsdBrowserController implements LsdBrowserController$1 {
 }
 declare const controller: LsdBrowserController;
 
-export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllElement, 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 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 PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, 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 };
+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 PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, 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 };