browsertime 26.3.1 → 27.0.0

package/types/core/engine/command/click.d.ts

@@ -1,11 +1,14 @@
 /**
  * Provides functionality to perform click actions on elements in a web page using various selectors.
+ * Uses the Selenium Actions API to generate real OS-level mouse events, which means
+ * the element must be visible and interactable. If you need to click a hidden element,
+ * use {@link JavaScript#run commands.js.run} to trigger a JavaScript click instead.
  *
  * @class
  * @hideconstructor
  */
 export class Click {
-    constructor(browser: any, pageCompleteCheck: any);
+    constructor(browser: any, pageCompleteCheck: any, options: any);
     /**
      * @private
      */
@@ -14,138 +17,206 @@ export class Click {
      * @private
      */
     private pageCompleteCheck;
+    /**
+     * @private
+     */
+    private options;
+    /**
+     * @private
+     */
+    private _waitForElement;
+    /**
+     * @private
+     */
+    private _andWait;
+    /**
+     * @private
+     */
+    private _clickElement;
+    /**
+     * Clicks on an element using a unified selector string.
+     * Supports CSS selectors (default), and prefix-based strategies:
+     * 'id:myId', 'xpath://button', 'text:Submit', 'link:Click here', 'name:email', 'class:btn'.
+     *
+     * @async
+     * @param {string} selector - The selector string. CSS by default, or use a prefix like 'id:', 'xpath:', 'text:', 'link:', 'name:', 'class:'.
+     * @param {Object} [options] - Options for the click action.
+     * @param {boolean} [options.waitForNavigation=false] - If true, waits for the page complete check after clicking.
+     * @returns {Promise<void>} A promise that resolves when the click action is performed.
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    run(selector: string, options?: {
+        waitForNavigation?: boolean;
+    }): Promise<void>;
     /**
      * Clicks on an element identified by its class name.
      *
      * @async
+     * @private
      * @param {string} className - The class name of the element to click.
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byClassName(className: string): Promise<void>;
+    private byClassName;
     /**
      * Clicks on an element identified by its class name and waits for the page complete check to finish.
      *
      * @async
+     * @private
      * @param {string} className - The class name of the element to click.
      * @returns {Promise<void>} A promise that resolves when the click action and page complete check are finished.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byClassNameAndWait(className: string): Promise<void>;
+    private byClassNameAndWait;
     /**
      * Clicks on a link whose visible text matches the given string.
      *
      * @async
+     * @private
      * @param {string} text - The visible text of the link to click.
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the link is not found.
      */
-    byLinkText(text: string): Promise<void>;
+    private byLinkText;
     /**
      * Clicks on a link whose visible text matches the given string and waits for the page complete check to finish.
      *
      * @async
+     * @private
      * @param {string} text - The visible text of the link to click.
      * @returns {Promise<void>} A promise that resolves when the click action and page complete check are finished.
      * @throws {Error} Throws an error if the link is not found.
      */
-    byLinkTextAndWait(text: string): Promise<void>;
+    private byLinkTextAndWait;
     /**
      * Clicks on a link whose visible text contains the given substring.
      *
      * @async
+     * @private
      * @param {string} text - The substring of the visible text of the link to click.
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the link is not found.
      */
-    byPartialLinkText(text: string): Promise<void>;
+    private byPartialLinkText;
     /**
      * Clicks on a link whose visible text contains the given substring and waits for the page complete check to finish.
      *
      * @async
+     * @private
      * @param {string} text - The substring of the visible text of the link to click.
      * @returns {Promise<void>} A promise that resolves when the click action and page complete check are finished.
      * @throws {Error} Throws an error if the link is not found.
      */
-    byPartialLinkTextAndWait(text: string): Promise<void>;
+    private byPartialLinkTextAndWait;
+    /**
+     * Clicks on an element whose visible text matches the given string.
+     * This works on any element type, not just links.
+     *
+     * @async
+     * @private
+     * @param {string} text - The visible text of the element to click.
+     * @returns {Promise<void>} A promise that resolves when the click action is performed.
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    private byText;
+    /**
+     * Clicks on an element whose visible text matches the given string and waits for the page complete check to finish.
+     * This works on any element type, not just links.
+     *
+     * @async
+     * @private
+     * @param {string} text - The visible text of the element to click.
+     * @returns {Promise<void>} A promise that resolves when the click action and page complete check are finished.
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    private byTextAndWait;
     /**
      * Clicks on an element that matches a given XPath selector.
      *
      * @async
+     * @private
      * @param {string} xpath - The XPath selector of the element to click.
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byXpath(xpath: string): Promise<void>;
+    private byXpath;
     /**
      * Clicks on an element that matches a given XPath selector and waits for the page complete check to finish.
      *
      * @async
+     * @private
      * @param {string} xpath - The XPath selector of the element to click.
      * @returns {Promise<void>} A promise that resolves when the click action and page complete check are finished.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byXpathAndWait(xpath: string): Promise<void>;
+    private byXpathAndWait;
     /**
      * Clicks on an element located by evaluating a JavaScript expression.
      *
      * @async
+     * @private
      * @param {string} js - The JavaScript expression that evaluates to an element or list of elements.
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byJs(js: string): Promise<void>;
+    private byJs;
     /**
      * Clicks on an element located by evaluating a JavaScript expression and waits for the page complete check to finish.
      *
      * @async
+     * @private
      * @param {string} js - The JavaScript expression that evaluates to an element or list of elements.
      * @returns {Promise<void>} A promise that resolves when the click action and page complete check are finished.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byJsAndWait(js: string): Promise<void>;
+    private byJsAndWait;
     /**
      * Clicks on an element located by its ID.
      *
      * @async
+     * @private
      * @param {string} id - The ID of the element to click.
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byId(id: string): Promise<void>;
+    private byId;
     /**
      * Clicks on an element located by its name attribute.
      *
      * @async
+     * @private
      * @param {string} name - The name attribute of the element to click.
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byName(name: string): Promise<void>;
+    private byName;
     /**
      * Click on link located by the ID attribute. Uses document.getElementById() to find the element. And wait for page complete check to finish.
+     * @private
      * @param {string} id
      * @returns {Promise<void>} Promise object represents when the element has been clicked and the pageCompleteCheck has finished.
      * @throws Will throw an error if the element is not found
      */
-    byIdAndWait(id: string): Promise<void>;
+    private byIdAndWait;
     /**
      * Clicks on an element located by its CSS selector.
      *
      * @async
+     * @private
      * @param {string} selector - The CSS selector of the element to click.
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    bySelector(selector: string): Promise<void>;
+    private bySelector;
     /**
      * Clicks on an element located by its CSS selector and waits for the page complete check to finish.
      *
      * @async
+     * @private
      * @param {string} selector - The CSS selector of the element to click.
      * @returns {Promise<void>} A promise that resolves when the click action and page complete check are finished.
      * @throws {Error} Throws an error if the element is not found.
      */
-    bySelectorAndWait(selector: string): Promise<void>;
+    private bySelectorAndWait;
 }
 //# sourceMappingURL=click.d.ts.map

package/types/core/engine/command/click.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/click.js"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH;IACE,kDASC;IARC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,0BAA0C;IAG5C;;;;;;;OAOG;IACH,uBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,8BAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAazB;IAED;;;;;;;OAOG;IACH,iBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,wBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,wBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,+BAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,eAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAczB;IACD;;;;;;;OAOG;IACH,sBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAezB;IAED;;;;;;;OAOG;IACH,SAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,gBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAazB;IAED;;;;;;;OAOG;IACH,SAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,aAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;OAKG;IACH,gBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAazB;IAED;;;;;;;OAOG;IACH,qBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,4BAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAazB;CACF"}
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/click.js"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH;IACE,gEAaC;IAZC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,0BAA0C;IAC1C;;OAEG;IACH,gBAAsB;IAGxB;;OAEG;IACH,wBAKC;IAED;;OAEG;IACH,iBAMC;IAED;;OAEG;IACH,sBAIC;IAED;;;;;;;;;;;OAWG;IACH,cANW,MAAM,YAEd;QAA0B,iBAAiB,GAAnC,OAAO;KACf,GAAU,OAAO,CAAC,IAAI,CAAC,CAoBzB;IAED;;;;;;;;OAQG;IACH,oBAcC;IAED;;;;;;;;OAQG;IACH,2BAEC;IAED;;;;;;;;OAQG;IACH,mBAQC;IAED;;;;;;;;OAQG;IACH,0BAQC;IAED;;;;;;;;OAQG;IACH,0BAQC;IAED;;;;;;;;OAQG;IACH,iCAQC;IAED;;;;;;;;;OASG;IACH,eAQC;IAED;;;;;;;;;OASG;IACH,sBAQC;IAED;;;;;;;;OAQG;IACH,gBAcC;IACD;;;;;;;;OAQG;IACH,uBAEC;IAED;;;;;;;;OAQG;IACH,aAeC;IAED;;;;;;;;OAQG;IACH,oBAEC;IAED;;;;;;;;OAQG;IACH,aAcC;IAED;;;;;;;;OAQG;IACH,eAcC;IAED;;;;;;OAMG;IACH,oBAEC;IAED;;;;;;;;OAQG;IACH,mBAcC;IAED;;;;;;;;OAQG;IACH,0BAEC;CACF"}

package/types/core/engine/command/commandHelper.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared error handling wrapper for command methods.
+ *
+ * Most command methods follow the same try/catch pattern:
+ * log.error + log.verbose + throw new Error. This helper
+ * eliminates that boilerplate.
+ *
+ * @param {Object} log - The logger instance.
+ * @param {string} errorMessage - printf-style message (with %s placeholder).
+ * @param {string|undefined} identifier - Value to interpolate into the message, or undefined if none.
+ * @param {Function} fn - The async function to execute.
+ * @param {Object} [browser] - Optional browser instance. When provided, the current page URL is appended to the error message.
+ * @returns {Promise<*>} The return value of fn.
+ */
+export function executeCommand(log: any, errorMessage: string, identifier: string | undefined, fn: Function, browser?: any): Promise<any>;
+//# sourceMappingURL=commandHelper.d.ts.map

package/types/core/engine/command/commandHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandHelper.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/commandHelper.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,uDANW,MAAM,cACN,MAAM,GAAC,SAAS,gCAGd,OAAO,CAAC,GAAC,CAAC,CAgCtB"}

package/types/core/engine/command/cookie.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Provides functionality to manage browser cookies.
+ *
+ * @class
+ * @hideconstructor
+ */
+export class Cookie {
+    constructor(browser: any);
+    /**
+     * @private
+     */
+    private driver;
+    /**
+     * Gets all cookies for the current page.
+     *
+     * @async
+     * @returns {Promise<Array>} An array of cookie objects.
+     */
+    getAll(): Promise<any[]>;
+    /**
+     * Gets a specific cookie by name.
+     *
+     * @async
+     * @param {string} name - The name of the cookie.
+     * @returns {Promise<Object|undefined>} The cookie object, or undefined if not found.
+     */
+    get(name: string): Promise<any | undefined>;
+    /**
+     * Sets a cookie.
+     *
+     * @async
+     * @param {string} name - The name of the cookie.
+     * @param {string} value - The value of the cookie.
+     * @param {Object} [options] - Optional cookie properties.
+     * @param {string} [options.domain] - The domain the cookie is visible to.
+     * @param {string} [options.path] - The cookie path.
+     * @param {boolean} [options.secure] - Whether the cookie is secure.
+     * @param {boolean} [options.httpOnly] - Whether the cookie is HTTP only.
+     * @param {Date} [options.expiry] - When the cookie expires.
+     * @returns {Promise<void>}
+     */
+    set(name: string, value: string, options?: {
+        domain?: string;
+        path?: string;
+        secure?: boolean;
+        httpOnly?: boolean;
+        expiry?: Date;
+    }): Promise<void>;
+    /**
+     * Deletes a specific cookie by name.
+     *
+     * @async
+     * @param {string} name - The name of the cookie to delete.
+     * @returns {Promise<void>}
+     */
+    delete(name: string): Promise<void>;
+    /**
+     * Deletes all cookies for the current page.
+     *
+     * @async
+     * @returns {Promise<void>}
+     */
+    deleteAll(): Promise<void>;
+}
+//# sourceMappingURL=cookie.d.ts.map

package/types/core/engine/command/cookie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/cookie.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IACE,0BAKC;IAJC;;OAEG;IACH,eAAiC;IAGnC;;;;;OAKG;IACH,UAFa,OAAO,OAAO,CAI1B;IAED;;;;;;OAMG;IACH,UAHW,MAAM,GACJ,OAAO,CAAC,MAAO,SAAS,CAAC,CAQrC;IAED;;;;;;;;;;;;;OAaG;IACH,UAVW,MAAM,SACN,MAAM,YAEd;QAAyB,MAAM,GAAvB,MAAM;QACW,IAAI,GAArB,MAAM;QACY,MAAM,GAAxB,OAAO;QACW,QAAQ,GAA1B,OAAO;QACQ,MAAM,GAArB,IAAI;KACZ,GAAU,OAAO,CAAC,IAAI,CAAC,CAMzB;IAED;;;;;;OAMG;IACH,aAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAKzB;IAED;;;;;OAKG;IACH,aAFa,OAAO,CAAC,IAAI,CAAC,CAKzB;CACF"}

package/types/core/engine/command/element.d.ts

@@ -4,11 +4,15 @@
  * @hideconstructor
  */
 export class Element {
-    constructor(browser: any);
+    constructor(browser: any, options: any);
     /**
      * @private
      */
     private driver;
+    /**
+     * @private
+     */
+    private options;
     /**
      * Finds an element by its CSS selector.
      *
@@ -44,6 +48,20 @@ export class Element {
      * @returns {Promise<WebElement>} A promise that resolves to the WebElement found.
      */
     getByName(name: string): Promise<WebElement>;
+    /**
+     * Finds an element using a CSS selector, with optional waiting and visibility check.
+     *
+     * @param {string} selector - The CSS selector of the element.
+     * @param {Object} [options] - Options for finding the element.
+     * @param {number} [options.timeout] - Maximum time in milliseconds to wait for the element. Defaults to the configured --timeouts.elementWait value.
+     * @param {boolean} [options.visible=false] - If true, waits for the element to be visible, not just present.
+     * @returns {Promise<WebElement>} A promise that resolves to the WebElement found.
+     * @throws {Error} Throws an error if the element is not found within the timeout.
+     */
+    find(selector: string, options?: {
+        timeout?: number;
+        visible?: boolean;
+    }): Promise<WebElement>;
 }
 import { WebElement } from 'selenium-webdriver';
 //# sourceMappingURL=element.d.ts.map

package/types/core/engine/command/element.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/element.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH;IACE,0BAKC;IAJC;;OAEG;IACH,eAAiC;IAGnC;;;;;OAKG;IACH,eAHW,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC,CAI/B;IAED;;;;;OAKG;IACH,YAHW,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC,CAI/B;IAED;;;;;OAKG;IACH,kBAHW,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC,CAI/B;IAED;;;;;OAKG;IACH,0BAHW,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC,CAI/B;IAED;;;;;OAKG;IACH,gBAHW,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC,CAI/B;CACF;2BA/D8B,oBAAoB"}
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/element.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH;IACE,wCASC;IARC;;OAEG;IACH,eAAiC;IACjC;;OAEG;IACH,gBAAsB;IAGxB;;;;;OAKG;IACH,eAHW,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC,CAI/B;IAED;;;;;OAKG;IACH,YAHW,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC,CAI/B;IAED;;;;;OAKG;IACH,kBAHW,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC,CAI/B;IAED;;;;;OAKG;IACH,0BAHW,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC,CAI/B;IAED;;;;;OAKG;IACH,gBAHW,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC,CAI/B;IAED;;;;;;;;;OASG;IACH,eAPW,MAAM,YAEd;QAAyB,OAAO,GAAxB,MAAM;QACY,OAAO,GAAzB,OAAO;KACf,GAAU,OAAO,CAAC,UAAU,CAAC,CAsB/B;CACF;2BAlGyC,oBAAoB"}

package/types/core/engine/command/javaScript.d.ts

@@ -14,6 +14,10 @@ export class JavaScript {
      * @private
      */
     private pageCompleteCheck;
+    /**
+     * @private
+     */
+    private _andWait;
     /**
      * Executes a JavaScript script.
      *

package/types/core/engine/command/javaScript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"javaScript.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/javaScript.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;IACE,kDASC;IARC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,0BAA0C;IAG5C;;;;;;;OAOG;IACH,QAJW,MAAM,GACJ,OAAO,CAAC,GAAC,CAAC,CAYtB;IAED;;;;;;;OAOG;IACH,eAJW,MAAM,GACJ,OAAO,CAAC,GAAC,CAAC,CAYtB;IAED;;;;;;;OAOG;IACH,kBAJW,MAAM,GACJ,OAAO,CAAC,GAAC,CAAC,CAetB;IAED;;;;;;;OAOG;IACH,yBAJW,MAAM,GACJ,OAAO,CAAC,GAAC,CAAC,CAYtB;IAED;;;;;;;OAOG;IACH,uBAJW,MAAM,GACJ,OAAO,CAAC,GAAC,CAAC,CAetB;CACF"}
+{"version":3,"file":"javaScript.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/javaScript.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH;IACE,kDASC;IARC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,0BAA0C;IAG5C;;OAEG;IACH,iBAGC;IAED;;;;;;;OAOG;IACH,QAJW,MAAM,GACJ,OAAO,CAAC,GAAC,CAAC,CAOtB;IAED;;;;;;;OAOG;IACH,eAJW,MAAM,GACJ,OAAO,CAAC,GAAC,CAAC,CAKtB;IAED;;;;;;;OAOG;IACH,kBAJW,MAAM,GACJ,OAAO,CAAC,GAAC,CAAC,CAetB;IAED;;;;;;;OAOG;IACH,yBAJW,MAAM,GACJ,OAAO,CAAC,GAAC,CAAC,CAKtB;IAED;;;;;;;OAOG;IACH,uBAJW,MAAM,GACJ,OAAO,CAAC,GAAC,CAAC,CAetB;CACF"}

package/types/core/engine/command/measure/screenshots.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Handles screenshot capture during measurement collection.
+ * @class
+ * @private
+ */
+export class MeasureScreenshots {
+    constructor(browser: any, screenshotManager: any, options: any);
+    browser: any;
+    screenshotManager: any;
+    options: any;
+    afterPageCompleteCheck(url: any, index: any): Promise<void>;
+    layoutShift(url: any, index: any): Promise<void>;
+    largestContentfulPaint(url: any, index: any): Promise<void>;
+}
+//# sourceMappingURL=screenshots.d.ts.map

package/types/core/engine/command/measure/screenshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots.d.ts","sourceRoot":"","sources":["../../../../../lib/core/engine/command/measure/screenshots.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH;IACE,gEAIC;IAHC,aAAsB;IACtB,uBAA0C;IAC1C,aAAsB;IAGxB,4DAgBC;IAED,iDA+BC;IAED,4DA4CC;CACF"}

package/types/core/engine/command/measure/video.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Handles video recording during measurement.
+ * @class
+ * @private
+ */
+export class MeasureVideo {
+    constructor(storageManager: any, browser: any, videos: any, options: any);
+    storageManager: any;
+    browser: any;
+    videos: any;
+    options: any;
+    recordVideo: any;
+    ANDROID_DELAY_TIME: any;
+    IOS_DELAY_TIME: any;
+    DESKTOP_DELAY_TIME: any;
+    start(numberOfMeasuredPages: any, index: any): Promise<any>;
+    video: Video;
+    stop(url: any): Promise<void>;
+    getRecordingMetadata(): {
+        recordingStartTime: number;
+        timeToFirstFrame: number;
+    };
+    shouldRecord(): boolean;
+}
+import { Video } from '../../../../video/video.js';
+//# sourceMappingURL=video.d.ts.map

package/types/core/engine/command/measure/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../../../../lib/core/engine/command/measure/video.js"],"names":[],"mappings":"AAMA;;;;GAIG;AACH;IACE,0EAiBC;IAhBC,oBAAoC;IACpC,aAAsB;IACtB,YAAoB;IACpB,aAAsB;IACtB,iBAAyD;IACzD,wBAIC;IACD,oBAAsE;IACtE,wBAIC;IAGH,4DAwBC;IAvBC,aAAuE;IAyBzE,8BAKC;IAED;;;MAeC;IAED,wBAEC;CACF;sBApFqB,4BAA4B"}

package/types/core/engine/command/measure.d.ts

@@ -6,7 +6,21 @@
  * @hideconstructor
  */
 export class Measure {
-    constructor(browser: any, index: any, pageCompleteCheck: any, result: any, engineDelegate: any, storageManager: any, videos: any, scriptsByCategory: any, asyncScriptsByCategory: any, postURLScripts: any, context: any, screenshotManager: any, options: any);
+    constructor({ browser, index, pageCompleteCheck, result, engineDelegate, storageManager, videos, scriptsByCategory, asyncScriptsByCategory, postURLScripts, context, screenshotManager, options }: {
+        browser: any;
+        index: any;
+        pageCompleteCheck: any;
+        result: any;
+        engineDelegate: any;
+        storageManager: any;
+        videos: any;
+        scriptsByCategory: any;
+        asyncScriptsByCategory: any;
+        postURLScripts: any;
+        context: any;
+        screenshotManager: any;
+        options: any;
+    });
     /**
      * @private
      */
@@ -31,22 +45,10 @@ export class Measure {
      * @private
      */
     private options;
-    /**
-     * @private
-     */
-    private screenshotManager;
     /**
      * @private
      */
     private storageManager;
-    /**
-     * @private
-     */
-    private recordVideo;
-    /**
-     * @private
-     */
-    private videos;
     /**
      * @private
      */
@@ -86,26 +88,11 @@ export class Measure {
     /**
      * @private
      */
-    private ANDROID_DELAY_TIME;
-    /**
-     * @private
-     */
-    private IOS_DELAY_TIME;
+    private measureVideo;
     /**
      * @private
      */
-    private DESKTOP_DELAY_TIME;
-    /**
-     * Have a consistent way of starting the video
-     * @private
-     */
-    private _startVideo;
-    video: Video;
-    /**
-     * Have a consistent way of starting stopping the video
-     * @private
-     */
-    private _stopVideo;
+    private screenshots;
     /**
      * Have a consistent way of adding an error
      * @private
@@ -161,6 +148,23 @@ export class Measure {
      * @since 21.2.0
      */
     stopAsError(errorMessage: string): Promise<any>;
+    /**
+     * @private
+     */
+    private setClick;
+    _click: any;
+    /**
+     * Starts a measurement, clicks on an element matching the given CSS selector,
+     * waits for the page complete check, and stops the measurement. This is
+     * a shortcut for the common pattern of measure.start/click/measure.stop.
+     *
+     * @async
+     * @param {string} alias - The friendly name for this measurement.
+     * @param {string} selector - The CSS selector of the element to click.
+     * @returns {Promise} A promise that resolves with the collected metrics data.
+     * @throws {Error} Throws an error if the element is not found or the measurement fails.
+     */
+    clickAndMeasure(alias: string, selector: string): Promise<any>;
     /**
      * Stops the measurement process, collects metrics, and handles any post-measurement tasks.
      * It finalizes the URL being tested, manages any URL-specific metadata, stops any ongoing video recordings,
@@ -194,10 +198,32 @@ export class Measure {
      */
     addObject(object: any): void;
     /**
-     *
      * @private
      */
-    private collect;
+    private _resolveAlias;
+    /**
+     * @private
+     */
+    private _attachVideoMetadata;
+    /**
+     * @private
+     */
+    private _collectBrowserScripts;
+    /**
+     * @private
+     */
+    private _filterUserTimings;
+    /**
+     * @private
+     */
+    private _collectAndroidProcessTime;
+    /**
+     * @private
+     */
+    private _runPostURLScripts;
+    /**
+     * @private
+     */
+    private _collect;
 }
-import { Video } from '../../../video/video.js';
 //# sourceMappingURL=measure.d.ts.map

package/types/core/engine/command/measure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/measure.js"],"names":[],"mappings":"AAgCA;;;;;;GAMG;AACH;IACE,gQA+GC;IAhGC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,0BAA0C;IAC1C;;OAEG;IACH,cAAkB;IAClB;;OAEG;IACH,eAAoB;IACpB;;OAEG;IACH,uBAAoC;IACpC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,0BAA0C;IAC1C;;OAEG;IACH,uBAAoC;IACpC;;OAEG;IACH,oBAAyD;IACzD;;OAEG;IACH,eAAoB;IACpB;;OAEG;IACH,0BAA0C;IAC1C;;OAEG;IACH,+BAAoD;IACpD;;OAEG;IACH,uBAAoC;IACpC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,8BAA8B;IAC9B;;OAEG;IACH,6BAA6B;IAC7B;;OAEG;IACH,uBAA2B;IAC3B;;OAEG;IACH,mBAAoB;IACpB;;OAEG;IACH,gBAA6D;IAC7D;;OAEG;IACH,2BAIC;IACD;;OAEG;IACH,uBAAsE;IACtE;;OAEG;IACH,2BAIC;IAGH;;;OAGG;IACH,oBAsBC;IArBC,aAAuE;IAuBzE;;;OAGG;IACH,mBAKC;IAED;;;OAGG;IACH,eAyBC;IAED;;;OAGG;IACH,iBAQC;IAED;;;;;;;;;;;;OAYG;IACH,kBAmBC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,kBALW,MAAM,kBACN,MAAM,GAEJ,OAAO,CAAC,IAAI,CAAC,CAmFzB;IAED;;;;;;;;OAQG;IACH,0BAJW,MAAM,gBAiBhB;IACD;;;;;;;;;OASG;IACH,qBAJW,MAAM,gBAyEhB;IAED;;;;;;;;OAQG;IACH,UAJW,MAAM,SACN,GAAC,QAWX;IAED;;;;;;;;;OASG;IACH,6BAOC;IAED;;;OAGG;IACH,gBAwLC;CACF;sBA7rBqB,yBAAyB"}
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/measure.js"],"names":[],"mappings":"AA6BA;;;;;;GAMG;AACH;IACE;;;;;;;;;;;;;;OAgGC;IAjFC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,0BAA0C;IAC1C;;OAEG;IACH,cAAkB;IAClB;;OAEG;IACH,eAAoB;IACpB;;OAEG;IACH,uBAAoC;IACpC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,uBAAoC;IACpC;;OAEG;IACH,0BAA0C;IAC1C;;OAEG;IACH,+BAAoD;IACpD;;OAEG;IACH,uBAAoC;IACpC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,8BAA8B;IAC9B;;OAEG;IACH,6BAA6B;IAC7B;;OAEG;IACH,uBAA2B;IAC3B;;OAEG;IACH,mBAAoB;IACpB;;OAEG;IACH,gBAA6D;IAC7D;;OAEG;IACH,qBAKC;IACD;;OAEG;IACH,oBAIC;IAGH;;;OAGG;IACH,eAyBC;IAED;;;OAGG;IACH,iBAQC;IAED;;;;;;;;;;;;OAYG;IACH,kBAmBC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,kBALW,MAAM,kBACN,MAAM,GAEJ,OAAO,CAAC,IAAI,CAAC,CA2FzB;IAED;;;;;;;;OAQG;IACH,0BAJW,MAAM,gBAiBhB;IAED;;OAEG;IACH,iBAEC;IADC,YAAmB;IAGrB;;;;;;;;;;OAUG;IACH,uBALW,MAAM,YACN,MAAM,gBAQhB;IAED;;;;;;;;;OASG;IACH,qBAJW,MAAM,gBAyEhB;IAED;;;;;;;;OAQG;IACH,UAJW,MAAM,SACN,GAAC,QAWX;IAED;;;;;;;;;OASG;IACH,6BAOC;IAED;;OAEG;IACH,sBAYC;IAED;;OAEG;IACH,6BAQC;IAED;;OAEG;IACH,+BAaC;IAED;;OAEG;IACH,2BAkBC;IAED;;OAEG;IACH,mCAqBC;IAED;;OAEG;IACH,2BAIC;IAED;;OAEG;IACH,iBA2BC;CACF"}

package/types/core/engine/command/mouse/clickAndHold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clickAndHold.d.ts","sourceRoot":"","sources":["../../../../../lib/core/engine/command/mouse/clickAndHold.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH;IACE,0BASC;IARC;;OAEG;IACH,eAAiC;IACjC;;OAEG;IACH,gBAAmD;IAGrD;;;;;;;OAOG;IACH,eAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAczB;IAED;;;;;;;OAOG;IACH,qBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAiBzB;IAED;;;;;;OAMG;IACH,YAHa,OAAO,CAAC,IAAI,CAAC,CAWzB;IAED;;;;;;;;OAQG;IACH,iBALW,MAAM,QACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAgBzB;IAED;;;;;;;OAOG;IACH,sBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,4BAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;;OAQG;IACH,wBALW,MAAM,QACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAgBzB;CACF"}
+{"version":3,"file":"clickAndHold.d.ts","sourceRoot":"","sources":["../../../../../lib/core/engine/command/mouse/clickAndHold.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH;IACE,0BASC;IARC;;OAEG;IACH,eAAiC;IACjC;;OAEG;IACH,gBAAmD;IAGrD;;;;;;;OAOG;IACH,eAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAczB;IAED;;;;;;;OAOG;IACH,qBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAiBzB;IAED;;;;;;OAMG;IACH,YAHa,OAAO,CAAC,IAAI,CAAC,CAWzB;IAED;;;;;;;;OAQG;IACH,iBALW,MAAM,QACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAgBzB;IAED;;;;;;;OAOG;IACH,sBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAazB;IAED;;;;;;;OAOG;IACH,4BAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAazB;IAED;;;;;;;;OAQG;IACH,wBALW,MAAM,QACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAiBzB;CACF"}

package/types/core/engine/command/mouse/contextClick.d.ts

@@ -5,7 +5,11 @@
  * @hideconstructor
  */
 export class ContextClick {
-    constructor(browser: any);
+    constructor(browser: any, options: any);
+    /**
+     * @private
+     */
+    private browser;
     /**
      * @private
      */
@@ -15,6 +19,24 @@ export class ContextClick {
      */
     private actions;
     /**
+     * @private
+     */
+    private options;
+    /**
+     * @private
+     */
+    private _waitForElement;
+    /**
+     * Performs a context click (right-click) on an element using a unified selector string.
+     *
+     * @async
+     * @param {string} selector - The selector string. CSS by default, or use a prefix.
+     * @returns {Promise<void>}
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    run(selector: string): Promise<void>;
+    /**
+     * @private
      * Performs a context click (right-click) on an element that matches a given XPath selector.
      *
      * @async
@@ -22,8 +44,9 @@ export class ContextClick {
      * @returns {Promise<void>} A promise that resolves when the context click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byXpath(xpath: string): Promise<void>;
+    private byXpath;
     /**
+     * @private
      * Performs a context click (right-click) on an element that matches a given CSS selector.
      *
      * @async
@@ -31,14 +54,15 @@ export class ContextClick {
      * @returns {Promise<void>} A promise that resolves when the context click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    bySelector(selector: string): Promise<void>;
+    private bySelector;
     /**
+     * @private
      * Performs a context click (right-click) at the current cursor position.
      *
      * @async
      * @returns {Promise<void>} A promise that resolves when the context click action is performed.
      * @throws {Error} Throws an error if the context click action cannot be performed.
      */
-    atCursor(): Promise<void>;
+    private atCursor;
 }
 //# sourceMappingURL=contextClick.d.ts.map