browsertime 20.0.0 → 21.0.0

package/package.json

@@ -1,24 +1,25 @@
 {
   "name": "browsertime",
   "description": "Get performance metrics from your web page using Browsertime.",
-  "version": "20.0.0",
+  "version": "21.0.0",
   "bin": "./bin/browsertime.js",
   "type": "module",
+  "types": "./types/scripting.d.ts",
   "dependencies": {
     "@cypress/xvfb": "1.2.4",
     "@devicefarmer/adbkit": "3.2.5",
     "@sitespeed.io/chromedriver": "120.0.6099-71",
     "@sitespeed.io/edgedriver": "120.0.2210-77",
-    "@sitespeed.io/geckodriver": "0.33.0-c",
+    "@sitespeed.io/geckodriver": "0.34.0",
     "@sitespeed.io/throttle": "5.0.0",
     "@sitespeed.io/tracium": "0.3.3",
-    "ff-test-bidi-har-export": "0.0.12",
     "btoa": "1.2.1",
     "chrome-har": "0.13.2",
     "chrome-remote-interface": "0.33.0",
     "dayjs": "1.11.10",
     "execa": "8.0.1",
     "fast-stats": "0.0.6",
+    "ff-test-bidi-har-export": "0.0.12",
     "find-up": "7.0.0",
     "get-port": "7.0.0",
     "hasbin": "1.2.3",
@@ -36,14 +37,18 @@
     "jimp": "0.22.10"
   },
   "devDependencies": {
+    "@types/selenium-webdriver": "4.1.21",
     "ava": "6.0.1",
+    "clean-jsdoc-theme": "4.2.17",
     "eslint": "8.55.0",
     "eslint-config-prettier": "9.1.0",
     "eslint-plugin-prettier": "5.0.1",
     "eslint-plugin-unicorn": "49.0.0",
+    "jsdoc": "4.0.2",
     "prettier": "3.1.1",
+    "serve": "14.2.1",
     "serve-handler": "6.1.5",
-    "serve": "14.2.1"
+    "typescript": "5.3.3"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -56,12 +61,14 @@
     "bin",
     "browserscripts",
     "browsersupport",
-    "visualmetrics",
+    "visualmetrics/visualmetrics-portable.py",
+    "visualmetrics/visualmetrics.py",
     "browsertime.png",
     "index.js",
     "lib",
     "package.json",
-    "vendor"
+    "vendor",
+    "types"
   ],
   "exports": "./index.js",
   "scripts": {
@@ -69,7 +76,10 @@
     "start-server": "serve test/data/html/",
     "stop-server": "sudo pkill serve",
     "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
+    "lint:fix": "eslint . --fix",
+    "tsc": "tsc",
+    "jsdoc": "jsdoc --configure jsdoc/jsdoc.json",
+    "prepublishOnly": "npm run lint && npm run tsc"
   },
   "author": "Peter Hedenskog",
   "contributors": [

package/types/android/index.d.ts

@@ -0,0 +1,70 @@
+export function isAndroidConfigured(options: any): boolean;
+export class Android {
+    constructor(options: any);
+    client: any;
+    id: any;
+    port: any;
+    screenBrightnessMode: number;
+    screenBrightness: number;
+    tmpDir: string;
+    _init(): Promise<void>;
+    device: any;
+    sdcard: any;
+    _runCommand(command: any): Promise<any>;
+    _runCommandAndGet(command: any): Promise<any>;
+    _runAsRootAndGet(command: any): Promise<any>;
+    _runAsRoot(command: any): Promise<boolean>;
+    _downloadFile(sourcePath: any, destinationPath: any): Promise<any>;
+    _downloadDir(sourcePath: any, destinationPath: any): Promise<void>;
+    getFullPathOnSdCard(path: any): string;
+    mkDirOnSdCard(dirName: any): Promise<any>;
+    removeFileOnSdCard(file: any): Promise<any>;
+    removePathOnSdCard(path: any): Promise<any>;
+    reboot(): Promise<any>;
+    getTemperature(): Promise<number>;
+    getMeta(): Promise<{
+        model: any;
+        name: any;
+        device: any;
+        androidVersion: any;
+        id: any;
+        wifi: any;
+    }>;
+    pullNetLog(destination: any): Promise<any>;
+    addDevtoolsFw(): Promise<any>;
+    removeDevtoolsFw(): Promise<({
+        all?: string;
+        isCanceled: boolean;
+    } & import("execa").ExecaReturnBase<string>)[]>;
+    startVideo(): Promise<any>;
+    ping(address: any): Promise<boolean>;
+    clickPowerButton(): Promise<any>;
+    getWifi(): Promise<any>;
+    closeAppNotRespondingPopup(): Promise<any>;
+    pressHomeButton(): Promise<any>;
+    stopVideo(): Promise<any>;
+    getPhoneState(): Promise<string>;
+    pullVideo(destinationPath: any): Promise<any>;
+    removeVideo(): Promise<any>;
+    pidof(packageName: any): Promise<any>;
+    _pidofWithPidof(packageName: any): Promise<number>;
+    _pidofWithPs(packageName: any): Promise<number>;
+    _processStartTime(pid: any): Promise<{
+        dateInMs: number;
+        systemUptimeInSeconds: any;
+        utilStartTimeAfterSystemStartTimeInJiffies: any;
+        processStartTimeAfterSystemStartTimeInJiffies: any;
+        jiffesPerSeconds: number;
+        processStartTimeInMs: number;
+    }>;
+    processStartTime(pid: any, count?: number): Promise<number>;
+    startPowerTesting(): Promise<void>;
+    stopPowerTesting(): Promise<void>;
+    resetPowerUsage(): Promise<void>;
+    measurePowerUsage(packageName: any): Promise<{
+        'full-screen': number;
+        'full-wifi': number;
+        total: number;
+    }>;
+}
+//# sourceMappingURL=index.d.ts.map

package/types/android/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/android/index.js"],"names":[],"mappings":"AAiiBA,2DAWC;AA/hBD;IACE,0BAwBC;IAfC,YAAgC;IAEhC,QAIC;IACD,UAAgC;IAGhC,6BAA6B;IAC7B,yBAA2B;IAC3B,eAAgC;IAKlC,uBAgBC;IALC,YAA4C;IAG1C,YAAoE;IAIxE,wCAEC;IAED,8CAIC;IAED,6CAIC;IAED,2CAUC;IAED,mEAYC;IAED,mEAcC;IAED,uCAEC;IAED,0CAGC;IAED,4CAMC;IAED,4CAMC;IAED,uBAGC;IAED,kCAOC;IAED;;;;;;;OAuBC;IAED,2CAKC;IAED,8BAKC;IAED;;;oDAuBC;IAED,2BAIC;IAED,qCAGC;IAED,iCAGC;IAED,wBASC;IAED,2CAOC;IAED,gCAEC;IAED,0BAIC;IAED,iCAGC;IAED,8CAIC;IAED,4BAEC;IAED,sCAYC;IAED,mDAsBC;IAED,gDA+CC;IAED;;;;;;;OAqDC;IAED,4DAQC;IAED,mCAcC;IAED,kCAQC;IAED,iCAIC;IAED;;;;OAGC;CACF"}

package/types/chrome/parseCpuTrace.d.ts

@@ -0,0 +1,21 @@
+export function parseCPUTrace(tracelog: any, url: any): Promise<{
+    categories: {
+        parseHTML: number;
+        styleLayout: number;
+        paintCompositeRender: number;
+        scriptParseCompile: number;
+        scriptEvaluation: number;
+        garbageCollection: number;
+        other: number;
+    };
+    events: {};
+    urls: {
+        url: string;
+        value: number;
+    }[];
+} | {
+    categories?: undefined;
+    events?: undefined;
+    urls?: undefined;
+}>;
+//# sourceMappingURL=parseCpuTrace.d.ts.map

package/types/chrome/parseCpuTrace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseCpuTrace.d.ts","sourceRoot":"","sources":["../../lib/chrome/parseCpuTrace.js"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;GA4EC"}

package/types/chrome/traceCategoriesParser.d.ts

@@ -0,0 +1,2 @@
+export function parse(events: any, url: any): any;
+//# sourceMappingURL=traceCategoriesParser.d.ts.map

package/types/chrome/traceCategoriesParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceCategoriesParser.d.ts","sourceRoot":"","sources":["../../lib/chrome/traceCategoriesParser.js"],"names":[],"mappings":"AA2JA,kDAQC"}

package/types/chrome/webdriver/traceUtilities.d.ts

@@ -0,0 +1,8 @@
+export function getRenderBlocking(trace: any): Promise<{
+    renderBlockingInfo: {};
+    renderBlocking: {
+        recalculateStyle: {};
+        requests: {};
+    };
+}>;
+//# sourceMappingURL=traceUtilities.d.ts.map

package/types/chrome/webdriver/traceUtilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceUtilities.d.ts","sourceRoot":"","sources":["../../../lib/chrome/webdriver/traceUtilities.js"],"names":[],"mappings":"AA8DA;;;;;;GAoCC"}

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

@@ -0,0 +1,73 @@
+/**
+ * This class provides an abstraction layer for Selenium's action sequence functionality.
+ * It allows for easy interaction with web elements using different locating strategies
+ * and simulating complex user gestures like mouse movements, key presses, etc.
+ *
+ * @class
+ * @hideconstructor
+ * @see https://www.selenium.dev/documentation/webdriver/actions_api/
+ */
+export class Action {
+    constructor(browser: any);
+    /**
+     * @private
+     */
+    private driver;
+    /**
+     * @private
+     */
+    private actions;
+    clear(): Promise<any>;
+    /**
+     * Retrieves the current action sequence builder.
+     * The actions builder can be used to chain multiple browser actions.
+     * @returns {SeleniumActions} The current Selenium Actions builder object for chaining browser actions.
+     *  @example
+     * // Example of using the actions builder to perform a drag-and-drop operation:
+     * const elementToDrag = await commands.action.getElementByCss('.draggable');
+     * const dropTarget = await commands.action.getElementByCss('.drop-target');
+     * await commands.action.getAction()
+     *   .dragAndDrop(elementToDrag, dropTarget)
+     *   .perform();
+     *
+     */
+    getAction(): SeleniumActions;
+    /**
+     * Finds an element by its CSS selector.
+     *
+     * @param {string} name - The CSS selector of the element.
+     * @returns {Promise<WebElement>} A promise that resolves to the WebElement found.
+     */
+    getElementByCss(name: string): Promise<WebElement>;
+    /**
+     * Finds an element by its ID.
+     *
+     * @param {string} id - The ID of the element.
+     * @returns {Promise<WebElement>} A promise that resolves to the WebElement found.
+     */
+    getElementById(id: string): Promise<WebElement>;
+    /**
+     * Finds an element by its XPath.
+     *
+     * @param {string} xpath - The XPath query of the element.
+     * @returns {Promise<WebElement>} A promise that resolves to the WebElement found.
+     */
+    getElementByXpath(xpath: string): Promise<WebElement>;
+    /**
+     * Finds an element by its class name.
+     *
+     * @param {string} className - The class name of the element.
+     * @returns {Promise<WebElement>} A promise that resolves to the WebElement found.
+     */
+    getElementByClassName(className: string): Promise<WebElement>;
+    /**
+     * Finds an element by its name attribute.
+     *
+     * @param {string} name - The name attribute of the element.
+     * @returns {Promise<WebElement>} A promise that resolves to the WebElement found.
+     */
+    getElementByName(name: string): Promise<WebElement>;
+}
+import { Actions as SeleniumActions } from 'selenium-webdriver';
+import { WebElement } from 'selenium-webdriver';
+//# sourceMappingURL=action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/action.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH;IACE,0BASC;IARC;;OAEG;IACH,eAAiC;IACjC;;OAEG;IACH,gBAAmD;IASrD,sBAEC;IAED;;;;;;;;;;;;OAYG;IACH,aAVa,eAAe,CAY3B;IAED;;;;;OAKG;IACH,sBAHW,MAAM,GACJ,QAAQ,UAAU,CAAC,CAI/B;IAED;;;;;OAKG;IACH,mBAHW,MAAM,GACJ,QAAQ,UAAU,CAAC,CAI/B;IAED;;;;;OAKG;IACH,yBAHW,MAAM,GACJ,QAAQ,UAAU,CAAC,CAI/B;IAED;;;;;OAKG;IACH,iCAHW,MAAM,GACJ,QAAQ,UAAU,CAAC,CAI/B;IAED;;;;;OAKG;IACH,uBAHW,MAAM,GACJ,QAAQ,UAAU,CAAC,CAI/B;CACF;2CAnG0D,oBAAoB;2BAApB,oBAAoB"}

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

@@ -0,0 +1,38 @@
+/**
+ * This class provides an abstraction layer for Selenium's action sequence functionality.
+ * It allows for easy interaction with web elements using different locating strategies
+ * and simulating complex user gestures like mouse movements, key presses, etc.
+ *
+ * @class
+ * @hideconstructor
+ * @see https://www.selenium.dev/documentation/webdriver/actions_api/
+ * @see https://www.selenium.dev/selenium/docs/api/javascript/module/selenium-webdriver/lib/input_exports_Actions.html
+ */
+export class Actions {
+    constructor(browser: any);
+    /**
+     * @private
+     */
+    private driver;
+    /**
+     * @private
+     */
+    private actions;
+    clear(): Promise<any>;
+    /**
+     * Retrieves the current action sequence builder.
+     * The actions builder can be used to chain multiple browser actions.
+     * @returns {SeleniumActions} The current Selenium Actions builder object for chaining browser actions.
+     *  @example
+     * // Example of using the actions builder to perform a drag-and-drop operation:
+     * const elementToDrag = await commands.action.getElementByCss('.draggable');
+     * const dropTarget = await commands.action.getElementByCss('.drop-target');
+     * await commands.action.getAction()
+     *   .dragAndDrop(elementToDrag, dropTarget)
+     *   .perform();
+     *
+     */
+    getActions(): SeleniumActions;
+}
+import { Actions as SeleniumActions } from 'selenium-webdriver/lib/input.js';
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/actions.js"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH;IACE,0BASC;IARC;;OAEG;IACH,eAAiC;IACjC;;OAEG;IACH,gBAAmD;IASrD,sBAEC;IAED;;;;;;;;;;;;OAYG;IACH,cAVa,eAAe,CAY3B;CACF;2CAjD0C,iCAAiC"}

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

@@ -0,0 +1,68 @@
+/**
+ * Provides functionality to add text to elements on a web page using various selectors.
+ * @class
+ * @hideconstructor
+ */
+export class AddText {
+    constructor(browser: any);
+    /**
+     * @private
+     */
+    private browser;
+    /**
+     * Adds text to an element identified by its ID.
+     *
+     * @async
+     * @example commands.addText.byId('mytext', 'id');
+     * @param {string} text - The text string to add.
+     * @param {string} id - The ID of the element.
+     * @returns {Promise<void>} A promise that resolves when the text has been added.
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    byId(text: string, id: string): Promise<void>;
+    /**
+     * Adds text to an element identified by its XPath.
+     *
+     * @async
+     * @example commands.addText.byXpath('mytext', 'xpath');
+     * @param {string} text - The text string to add.
+     * @param {string} xpath - The XPath of the element.
+     * @returns {Promise<void>} A promise that resolves when the text has been added.
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    byXpath(text: string, xpath: string): Promise<void>;
+    /**
+     * Adds text to an element identified by its CSS selector.
+     *
+     * @async
+     * @example commands.addText.bySelector('mytext', 'selector');
+     * @param {string} text - The text string to add.
+     * @param {string} selector - The CSS selector of the element.
+     * @returns {Promise<void>} A promise that resolves when the text has been added.
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    bySelector(text: string, selector: string): Promise<void>;
+    /**
+     * Adds text to an element identified by its class name.
+     *
+     * @async
+     * @example commands.addText.byClassName('mytext', 'className');
+     * @param {string} text - The text string to add.
+     * @param {string} className - The class name of the element.
+     * @returns {Promise<void>} A promise that resolves when the text has been added.
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    byClassName(text: string, className: string): Promise<void>;
+    /**
+     * Adds text to an element identified by its name attribute.
+     *
+     * @async
+     * @example commands.addText.byName('mytext', 'name');
+     * @param {string} text - The text string to add.
+     * @param {string} name - The name attribute of the element.
+     * @returns {Promise<void>} A promise that resolves when the text has been added.
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    byName(text: string, name: string): Promise<void>;
+}
+//# sourceMappingURL=addText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"addText.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/addText.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH;IACE,0BAKC;IAJC;;OAEG;IACH,gBAAsB;IAGxB;;;;;;;;;OASG;IACH,WALW,MAAM,MACN,MAAM,GACJ,QAAQ,IAAI,CAAC,CAezB;IAED;;;;;;;;;OASG;IACH,cALW,MAAM,SACN,MAAM,GACJ,QAAQ,IAAI,CAAC,CAezB;IAED;;;;;;;;;OASG;IACH,iBALW,MAAM,YACN,MAAM,GACJ,QAAQ,IAAI,CAAC,CAezB;IAED;;;;;;;;;OASG;IACH,kBALW,MAAM,aACN,MAAM,GACJ,QAAQ,IAAI,CAAC,CAezB;IAED;;;;;;;;;OASG;IACH,aALW,MAAM,QACN,MAAM,GACJ,QAAQ,IAAI,CAAC,CAezB;CACF"}

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

@@ -0,0 +1,39 @@
+/**
+ * Provides functionality to interact with an Android device through shell commands.
+ * @class
+ * @see https://www.sitespeed.io/documentation/sitespeed.io/mobile-phones/#test-on-android
+ * @hideconstructor
+ */
+export class AndroidCommand {
+    constructor(options: any);
+    /**
+     * @private
+     */
+    private options;
+    /**
+     * Runs a shell command on the connected Android device.
+     * This method requires the Android device to be properly configured.
+     *
+     * @async
+     * @example await commands.android.shell('');
+     * @param {string} command - The shell command to run on the Android device.
+     * @returns {Promise<string>} A promise that resolves with the result of the command or rejects if there's an error.
+     * @throws {Error} Throws an error if Android is not configured or if the command fails.
+     */
+    shell(command: string): Promise<string>;
+    a: Android;
+    /**
+     * Runs a shell command on the connected Android device as the root user.
+     * This method requires the Android device to be properly configured and that you
+     * rooted the device.
+     *
+     * @async
+     * @example await commands.android.shellAsRoot('');
+     * @param {string} command - The shell command to run on the Android device as root.
+     * @returns {Promise<string>} A promise that resolves with the result of the command or rejects if there's an error.
+     * @throws {Error} Throws an error if Android is not configured or if the command fails.
+     */
+    shellAsRoot(command: string): Promise<string>;
+}
+import { Android } from '../../../android/index.js';
+//# sourceMappingURL=android.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"android.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/android.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IACE,0BAKC;IAJC;;OAEG;IACH,gBAAsB;IAGxB;;;;;;;;;OASG;IACH,eAJW,MAAM,GACJ,QAAQ,MAAM,CAAC,CAc3B;IAPK,WAAkC;IASxC;;;;;;;;;;OAUG;IACH,qBAJW,MAAM,GACJ,QAAQ,MAAM,CAAC,CAgB3B;CACF;wBAhE4C,2BAA2B"}

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

@@ -0,0 +1,53 @@
+/**
+ * Manage the browser cache.
+ * This class provides methods to clear the cache and cookies in different browsers.
+ *
+ * @class
+ * @hideconstructor
+ */
+export class Cache {
+    constructor(browser: any, browserName: any, extensionServer: any, cdp: any);
+    /**
+     * @private
+     */
+    private browser;
+    /**
+     * @private
+     */
+    private browserName;
+    /**
+     * @private
+     */
+    private extensionServer;
+    /**
+     * @private
+     */
+    private cdp;
+    /**
+     * Clears the browser cache. This includes both cache and cookies.
+     *
+     * For Firefox, it uses the extensionServer setup with specific options.
+     * For Chrome and Edge, it uses the Chrome DevTools Protocol (CDP) commands.
+     * If the browser is not supported, logs an error message.
+     *
+     * @async
+     * @example await commands.cache.clear();
+     * @throws Will throw an error if the browser is not supported.
+     * @returns {Promise<void>} A promise that resolves when the cache and cookies are cleared.
+     */
+    clear(): Promise<void>;
+    /**
+     * Clears the browser cache while keeping the cookies.
+     *
+     * For Firefox, it uses the extensionServer setup with specific options.
+     * For Chrome and Edge, it uses the Chrome DevTools Protocol (CDP) command to clear the cache.
+     * If the browser is not supported, logs an error message.
+     *
+     * @async
+     * @example await commands.cache.clearKeepCookies();
+     * @throws Will throw an error if the browser is not supported.
+     * @returns {Promise<void>} A promise that resolves when the cache is cleared but cookies are kept.
+     */
+    clearKeepCookies(): Promise<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/cache.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH;IACE,4EAiBC;IAhBC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,oBAA8B;IAC9B;;OAEG;IACH,wBAAsC;IACtC;;OAEG;IACH,YAAc;IAGhB;;;;;;;;;;;OAWG;IACH,SAFa,QAAQ,IAAI,CAAC,CAgBzB;IAED;;;;;;;;;;;OAWG;IACH,oBAFa,QAAQ,IAAI,CAAC,CAezB;CACF"}

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

@@ -0,0 +1,61 @@
+/**
+ * Manages interactions with the Chrome DevTools Protocol for Chrome and Edge browsers.
+ * Allows sending commands and setting up event listeners via the protocol.
+ *
+ * @class
+ * @hideconstructor
+ * @see https://chromedevtools.github.io/devtools-protocol/
+ */
+export class ChromeDevelopmentToolsProtocol {
+    constructor(engineDelegate: any, browserName: any);
+    /**
+     * @private
+     */
+    private engineDelegate;
+    /**
+     * @private
+     */
+    private browserName;
+    /**
+     * Sets up an event listener for a specific DevTools Protocol event.
+     *
+     * @async
+     * @param {string} event - The name of the event to listen for.
+     * @param {Function} f - The callback function to execute when the event is triggered.
+     * @throws {Error} Throws an error if the browser is not supported or if setting the listener fails.
+     */
+    on(event: string, f: Function): Promise<void>;
+    /**
+     * Sends a command to the DevTools Protocol and returns the result.
+     *
+     * @async
+     * @example const domCounters = await commands.cdp.sendAndGet('Memory.getDOMCounters');
+     * @see https://chromedevtools.github.io/devtools-protocol/
+     * @param {string} command - The DevTools Protocol command to send.
+     * @param {Object} arguments_ - The arguments for the command.
+     * @throws {Error} Throws an error if the browser is not supported or if the command fails.
+     * @returns {Promise<Object>} The result of the command execution.
+     */
+    sendAndGet(command: string, arguments_: any): Promise<any>;
+    /**
+     * Retrieves the raw client for the DevTools Protocol.
+     * @example const cdpClient = commands.cdp.getRawClient();
+     * @returns {Object} The raw DevTools Protocol client.
+     * @throws {Error} Throws an error if the browser is not supported.
+     * @see https://github.com/cyrus-and/chrome-remote-interface
+     */
+    getRawClient(): any;
+    /**
+     * Sends a command to the DevTools Protocol.
+     *
+     * @async
+     * @example await commands.cdp.send('');
+     * @see https://chromedevtools.github.io/devtools-protocol/
+     * @param {string} command - The DevTools Protocol command to send.
+     * @param {Object} arguments_ - The arguments for the command.
+     * @throws {Error} Throws an error if the browser is not supported or if the command fails.
+     * @returns {Promise<void>} A promise that resolves when the command has been sent.
+     */
+    send(command: string, arguments_: any): Promise<void>;
+}
+//# sourceMappingURL=chromeDevToolsProtocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chromeDevToolsProtocol.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/chromeDevToolsProtocol.js"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH;IACE,mDASC;IARC;;OAEG;IACH,uBAAoC;IACpC;;OAEG;IACH,oBAA8B;IAGhC;;;;;;;OAOG;IACH,UAJW,MAAM,8BAuBhB;IAED;;;;;;;;;;OAUG;IACH,oBALW,MAAM,oBAGJ,YAAe,CAsB3B;IAED;;;;;;OAMG;IACH,oBAMC;IAED;;;;;;;;;;OAUG;IACH,cALW,MAAM,oBAGJ,QAAQ,IAAI,CAAC,CAmBzB;CACF"}

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

@@ -0,0 +1,45 @@
+/**
+ * Manages Chrome trace functionality, enabling custom profiling and trace collection in Chrome.
+ *
+ * @class
+ * @hideconstructor
+ */
+export class ChromeTrace {
+    constructor(engineDelegate: any, index: any, options: any, result: any);
+    /**
+     * @private
+     */
+    private engineDelegate;
+    /**
+     * @private
+     */
+    private options;
+    /**
+     * @private
+     */
+    private result;
+    /**
+     * @private
+     */
+    private index;
+    /**
+     * Starts the Chrome trace collection.
+     *
+     * @async
+     * @example await commands.trace.start();
+     * @returns {Promise<void>} A promise that resolves when tracing is started.
+     * @throws {Error} Throws an error if not running Chrome or if configuration is not set for custom tracing.
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the Chrome trace collection, processes the collected data, and attaches it to the result object.
+     *
+     * @async
+     * @example await commands.trace.stop();
+     * @returns {Promise<void>} A promise that resolves when tracing is stopped and data is processed.
+     * @throws {Error} Throws an error if not running Chrome or if custom tracing was not started.
+     */
+    stop(): Promise<void>;
+    events: any;
+}
+//# sourceMappingURL=chromeTrace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chromeTrace.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/chromeTrace.js"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH;IACE,wEAiBC;IAhBC;;OAEG;IACH,uBAAoC;IACpC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,eAAoB;IACpB;;OAEG;IACH,cAAkB;IAGpB;;;;;;;OAOG;IACH,SAHa,QAAQ,IAAI,CAAC,CAezB;IAED;;;;;;;OAOG;IACH,QAHa,QAAQ,IAAI,CAAC,CAuCzB;IA/BK,YAAgB;CAgCvB"}