testplane 9.0.0-rc.3 → 9.0.0

package/build/src/browser/camera/index.d.ts

@@ -1,29 +1,26 @@
 import { Image } from "../../image";
-export interface ImageArea {
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-}
+import type { CropMargins } from "./utils";
+import { type Point, type Rect, type Size } from "../isomorphic/geometry";
 export type ScreenshotMode = "fullpage" | "viewport" | "auto";
-export interface PageMeta {
-    viewport: ImageArea;
-    documentHeight: number;
-    documentWidth: number;
-}
-interface Calibration {
-    left: number;
-    top: number;
+export type { CropMargins } from "./utils";
+export interface CaptureViewportImageOpts {
+    viewportOffset: Point<"page", "device">;
+    viewportSize: Size<"device">;
+    /** Delay before taking the screenshot, in milliseconds. */
+    screenshotDelay?: number;
+    /** Additional raw screenshot margins to crop, in physical pixels. */
+    cropMargins?: CropMargins;
 }
 export declare class Camera {
     private _screenshotMode;
     private _takeScreenshot;
-    private _calibration;
+    private _calibratedArea;
+    private _calibrationScreenshotSize;
+    private _debugTmpDir;
     static create(screenshotMode: ScreenshotMode, takeScreenshot: () => Promise<string>): Camera;
     constructor(screenshotMode: ScreenshotMode, takeScreenshot: () => Promise<string>);
-    calibrate(calibration: Calibration): void;
-    captureViewportImage(page?: PageMeta): Promise<Image>;
-    private _calibrateArea;
+    calibrate(calibratedArea: Rect<"image", "device">, screenshotSize: Size<"device">): void;
+    captureViewportImage(opts?: CaptureViewportImageOpts): Promise<Image>;
+    private _cropAreaToIntersection;
     private _cropAreaToViewport;
 }
-export {};

package/build/src/browser/camera/index.js

@@ -27,55 +27,102 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Camera = void 0;
-const lodash_1 = __importDefault(require("lodash"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const debug_1 = __importDefault(require("debug"));
 const image_1 = require("../../image");
 const utils = __importStar(require("./utils"));
+const logger = __importStar(require("../../utils/logger"));
+const geometry_1 = require("../isomorphic/geometry");
+const help_1 = require("../../constants/help");
+const debug = (0, debug_1.default)("testplane:screenshots:camera");
 class Camera {
     static create(screenshotMode, takeScreenshot) {
         return new this(screenshotMode, takeScreenshot);
     }
     constructor(screenshotMode, takeScreenshot) {
+        this._debugTmpDir = null;
         this._screenshotMode = screenshotMode;
         this._takeScreenshot = takeScreenshot;
-        this._calibration = null;
+        this._calibratedArea = null;
+        this._calibrationScreenshotSize = null;
+        if (process.env.TESTPLANE_DEBUG_SCREENSHOTS) {
+            this._debugTmpDir = node_path_1.default.join(node_os_1.default.tmpdir(), `testplane-camera-viewports-${Math.random().toString(36).slice(2)}`);
+            console.log("Debug camera images will be saved to: ", this._debugTmpDir);
+        }
     }
-    calibrate(calibration) {
-        this._calibration = calibration;
+    calibrate(calibratedArea, screenshotSize) {
+        debug("Setting calibrated area: %O for screenshot size: %O", calibratedArea, screenshotSize ?? null);
+        this._calibratedArea = calibratedArea;
+        this._calibrationScreenshotSize = screenshotSize;
     }
-    async captureViewportImage(page) {
+    async captureViewportImage(opts) {
+        if (opts?.screenshotDelay) {
+            await new Promise(resolve => setTimeout(resolve, opts.screenshotDelay));
+        }
         const base64 = await this._takeScreenshot();
         const image = image_1.Image.fromBase64(base64);
-        const { width, height } = await image.getSize();
-        const imageArea = { left: 0, top: 0, width, height };
-        const calibratedArea = this._calibrateArea(imageArea);
-        const viewportCroppedArea = this._cropAreaToViewport(calibratedArea, page);
+        const { width, height } = image.getSize();
+        const imageArea = {
+            left: 0,
+            top: 0,
+            width,
+            height,
+        };
+        const shouldApplyCalibration = this._calibrationScreenshotSize !== null &&
+            this._calibrationScreenshotSize.width === width &&
+            this._calibrationScreenshotSize.height === height;
+        const calibrationArea = shouldApplyCalibration ? this._calibratedArea : null;
+        const calibratedImageArea = this._cropAreaToIntersection(imageArea, calibrationArea);
+        const cropMarginsArea = utils.cropMarginsToRect(imageArea, opts?.cropMargins);
+        const croppedImageArea = (0, geometry_1.getIntersection)(calibratedImageArea, cropMarginsArea);
+        if (croppedImageArea === null) {
+            throw new Error(`Invalid cropMargins option: resulting screenshot crop area is empty. ` +
+                `imageSize: ${(0, geometry_1.prettySize)(imageArea)}, cropMargins: ${JSON.stringify(opts?.cropMargins)}`);
+        }
+        const viewportCroppedArea = this._cropAreaToViewport(croppedImageArea, { width, height }, croppedImageArea, opts);
+        await utils.saveViewportImageForDebugIfNeeded(image, croppedImageArea, this._debugTmpDir);
         if (viewportCroppedArea.width !== width || viewportCroppedArea.height !== height) {
             await image.crop(viewportCroppedArea);
         }
         return image;
     }
-    _calibrateArea(imageArea) {
-        if (!this._calibration) {
+    _cropAreaToIntersection(imageArea, cropArea) {
+        if (!cropArea) {
             return imageArea;
         }
-        const { left, top } = this._calibration;
-        return { left, top, width: imageArea.width - left, height: imageArea.height - top };
-    }
-    _cropAreaToViewport(imageArea, page) {
-        if (!page) {
+        const intersection = (0, geometry_1.getIntersection)(imageArea, cropArea);
+        if (intersection === null) {
+            logger.warn(`No intersection found between image area and crop area, falling back to original image area.\n` +
+                `imageArea: ${(0, geometry_1.prettyRect)(imageArea)}, cropArea: ${(0, geometry_1.prettyRect)(cropArea)}\n` +
+                `This likely means Testplane incorrectly determined area free of system UI elements. You can let us know at ${help_1.NEW_ISSUE_LINK}, providing this log and browser used.`);
             return imageArea;
         }
-        const isFullPage = utils.isFullPage(imageArea, page, this._screenshotMode);
-        const cropArea = lodash_1.default.clone(page.viewport);
+        return intersection;
+    }
+    /* On some browsers, e.g. older firefox versions, the screenshot returned by the browser can be the whole page
+       (even beyond the viewport, potentially spanning thousands of pixels down).
+       This function is used to detect such cases and crop the image to the viewport, always. */
+    _cropAreaToViewport(imageAreaToCrop, originalImageSize, calibrationArea, opts) {
+        if (!opts?.viewportSize || !opts?.viewportOffset) {
+            return imageAreaToCrop;
+        }
+        const isFullPage = utils.isFullPage(imageAreaToCrop, originalImageSize, calibrationArea ?? imageAreaToCrop, this._screenshotMode);
+        const cropArea = { ...opts.viewportSize, ...opts.viewportOffset };
         if (!isFullPage) {
-            lodash_1.default.extend(cropArea, { top: 0, left: 0 });
+            return imageAreaToCrop;
         }
-        return {
-            left: imageArea.left + cropArea.left,
-            top: imageArea.top + cropArea.top,
-            width: Math.min(imageArea.width - cropArea.left, cropArea.width),
-            height: Math.min(imageArea.height - cropArea.top, cropArea.height),
-        };
+        debug("cropping area to viewport.\n  imageArea: %O\n  viewportSize: %O\n  viewportOffset: %O\n  cropArea: %O\n  isFullPage: %s\n  screenshotMode: %s\n  documentSize: %O", imageAreaToCrop, opts.viewportSize, opts.viewportOffset, cropArea, isFullPage, this._screenshotMode);
+        const result = (0, geometry_1.getIntersection)(imageAreaToCrop, cropArea);
+        if (result === null) {
+            logger.warn(`No intersection found between image area and viewport area, falling back to original image area.\n` +
+                `imageArea: ${(0, geometry_1.prettyRect)(imageAreaToCrop)},\n` +
+                `viewportSize: ${(0, geometry_1.prettySize)(opts.viewportSize)},\n` +
+                `viewportOffset: ${(0, geometry_1.prettyPoint)(opts.viewportOffset)}\n` +
+                `This likely means Testplane incorrectly determined whether returned image is full page and viewport state. You can let us know at ${help_1.NEW_ISSUE_LINK}, providing this log and browser used.`);
+            return imageAreaToCrop;
+        }
+        return result;
     }
 }
 exports.Camera = Camera;

package/build/src/browser/camera/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/browser/camera/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oDAAuB;AACvB,uCAAoC;AACpC,+CAAiC;AAsBjC,MAAa,MAAM;IAKf,MAAM,CAAC,MAAM,CAAC,cAA8B,EAAE,cAAqC;QAC/E,OAAO,IAAI,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC;IAED,YAAY,cAA8B,EAAE,cAAqC;QAC7E,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,SAAS,CAAC,WAAwB;QAC9B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,IAAe;QACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,aAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAEvC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QAChD,MAAM,SAAS,GAAc,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAEhE,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAE3E,IAAI,mBAAmB,CAAC,KAAK,KAAK,KAAK,IAAI,mBAAmB,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC/E,MAAM,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAEO,cAAc,CAAC,SAAoB;QACvC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrB,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC;QAExC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;IACxF,CAAC;IAEO,mBAAmB,CAAC,SAAoB,EAAE,IAAe;QAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3E,MAAM,QAAQ,GAAG,gBAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAExC,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,gBAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO;YACH,IAAI,EAAE,SAAS,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI;YACpC,GAAG,EAAE,SAAS,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG;YACjC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC;YAChE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC;SACrE,CAAC;IACN,CAAC;CACJ;AAjED,wBAiEC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/browser/camera/index.ts"],"names":[],"mappings":"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"}

package/build/src/browser/camera/utils.d.ts

@@ -1,2 +1,15 @@
-import { ImageArea, PageMeta, ScreenshotMode } from ".";
-export declare const isFullPage: (imageArea: ImageArea, page: PageMeta, screenshotMode: ScreenshotMode) => boolean;
+import type { ScreenshotMode } from ".";
+import { Image } from "../../image";
+import { Rect, Size } from "../isomorphic/geometry";
+export interface CropMargins {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+type NormalizedCropMargins = Required<CropMargins>;
+export declare const isFullPage: (imageSize: Rect<"image", "device">, viewportSize: Size<"device">, calibratedArea: Rect<"image", "device">, screenshotMode: ScreenshotMode) => boolean;
+export declare const normalizeCropMargins: (cropMargins?: CropMargins) => NormalizedCropMargins;
+export declare const cropMarginsToRect: (imageArea: Rect<"image", "device">, cropMargins?: CropMargins) => Rect<"image", "device">;
+export declare function saveViewportImageForDebugIfNeeded(viewportImage: Image, viewportCroppedArea: Rect<"image", "device">, debugDir: string | null): Promise<void>;
+export {};

package/build/src/browser/camera/utils.js

@@ -1,18 +1,71 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isFullPage = void 0;
-const isFullPage = (imageArea, page, screenshotMode) => {
+exports.saveViewportImageForDebugIfNeeded = exports.cropMarginsToRect = exports.normalizeCropMargins = exports.isFullPage = void 0;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const geometry_1 = require("../isomorphic/geometry");
+const debug_utils_1 = require("../screen-shooter/composite-image/debug-utils");
+const isFullPage = (imageSize, viewportSize, calibratedArea, screenshotMode) => {
+    // "system ui" is something like status bar on safari mobile, or address bar at the bottom
+    const systemUiHeight = calibratedArea.top + (imageSize.height - (0, geometry_1.getBottom)(calibratedArea));
     switch (screenshotMode) {
         case "fullpage":
             return true;
         case "viewport":
             return false;
         case "auto":
-            return compareDimensions(imageArea, page);
+            return imageSize.height > viewportSize.height + systemUiHeight;
     }
 };
 exports.isFullPage = isFullPage;
-function compareDimensions(imageArea, page) {
-    return imageArea.height >= page.documentHeight && imageArea.width >= page.documentWidth;
+const normalizeCropMargins = (cropMargins) => {
+    const result = {
+        top: cropMargins?.top ?? 0,
+        right: cropMargins?.right ?? 0,
+        bottom: cropMargins?.bottom ?? 0,
+        left: cropMargins?.left ?? 0,
+    };
+    for (const side of ["top", "right", "bottom", "left"]) {
+        const value = result[side];
+        if (typeof value !== "number" || !Number.isFinite(value) || value < 0 || Math.floor(value) !== value) {
+            throw new Error(`Invalid cropMargins.${side} option: expected a non-negative integer, got ${String(value)}`);
+        }
+    }
+    return result;
+};
+exports.normalizeCropMargins = normalizeCropMargins;
+const cropMarginsToRect = (imageArea, cropMargins) => {
+    const margins = (0, exports.normalizeCropMargins)(cropMargins);
+    return {
+        top: margins.top,
+        left: margins.left,
+        width: imageArea.width - margins.left - margins.right,
+        height: imageArea.height - margins.top - margins.bottom,
+    };
+};
+exports.cropMarginsToRect = cropMarginsToRect;
+async function saveViewportImageForDebugIfNeeded(viewportImage, viewportCroppedArea, debugDir) {
+    if (!process.env.TESTPLANE_DEBUG_SCREENSHOTS || !debugDir) {
+        return;
+    }
+    try {
+        fs_1.default.mkdirSync(debugDir, { recursive: true });
+        const timestamp = String(Date.now()).padStart(13, "0");
+        const randomId = Math.random().toString(36).substring(2, 8);
+        const outputPath = path_1.default.join(debugDir, `viewport-${timestamp}-${randomId}.png`);
+        await (0, debug_utils_1.saveViewportImageWithDebugRects)(viewportImage, [
+            {
+                rect: viewportCroppedArea,
+                color: { r: 0, g: 255, b: 0, a: 255 },
+            },
+        ], outputPath);
+    }
+    catch (error) {
+        console.warn("Failed to save camera viewport debug image: %O", error);
+    }
 }
+exports.saveViewportImageForDebugIfNeeded = saveViewportImageForDebugIfNeeded;
 //# sourceMappingURL=utils.js.map

package/build/src/browser/camera/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/browser/camera/utils.ts"],"names":[],"mappings":";;;AAEO,MAAM,UAAU,GAAG,CAAC,SAAoB,EAAE,IAAc,EAAE,cAA8B,EAAW,EAAE;IACxG,QAAQ,cAAc,EAAE,CAAC;QACrB,KAAK,UAAU;YACX,OAAO,IAAI,CAAC;QAChB,KAAK,UAAU;YACX,OAAO,KAAK,CAAC;QACjB,KAAK,MAAM;YACP,OAAO,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;AACL,CAAC,CAAC;AATW,QAAA,UAAU,cASrB;AAEF,SAAS,iBAAiB,CAAC,SAAoB,EAAE,IAAc;IAC3D,OAAO,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,cAAc,IAAI,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC;AAC5F,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/browser/camera/utils.ts"],"names":[],"mappings":"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"}

package/build/src/browser/cdp/connection.d.ts

@@ -0,0 +1,15 @@
+import type { CDPEvent, CDPRequest } from "./types";
+import type { Browser } from "../types";
+type OnEventMessageFn = (cdpEventMessage: CDPEvent) => unknown;
+export declare class CDPConnection {
+    onEventMessage: OnEventMessageFn | null;
+    private readonly _wsConnection;
+    private constructor();
+    /** @description Creates CDPConnection without establishing it */
+    static create(browser: Browser): Promise<CDPConnection>;
+    close(): void;
+    private _onMessage;
+    /** @description Performs high-level CDP request with retries and timeouts */
+    request<T = void>(method: CDPRequest["method"], { params, sessionId }?: Omit<CDPRequest, "id" | "method">): Promise<T>;
+}
+export {};

package/build/src/browser/cdp/connection.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CDPConnection = void 0;
+const node_util_1 = require("node:util");
+const debug_1 = require("./debug");
+const ws_endpoint_1 = require("./ws-endpoint");
+const utils_1 = require("./utils");
+const error_1 = require("./error");
+const constants_1 = require("./constants");
+const ws_connection_1 = require("../../ws-connection");
+const constants_2 = require("../../ws-connection/constants");
+const error_2 = require("../../ws-connection/error");
+const utils_2 = require("../../ws-connection/utils");
+class CDPConnection {
+    constructor(cdpWsEndpoint, headers) {
+        this.onEventMessage = null;
+        this._wsConnection = new ws_connection_1.WsConnection(cdpWsEndpoint, {
+            headers,
+            debugFn: debug_1.debugCdp,
+            retries: {
+                count: constants_1.CDP_CONNECTION_RETRIES,
+                baseDelay: constants_1.CDP_CONNECTION_RETRY_BASE_DELAY,
+            },
+            timeouts: {
+                request: constants_1.CDP_REQUEST_TIMEOUT,
+                createSession: constants_1.CDP_CONNECTION_TIMEOUT,
+            },
+            errors: {
+                ConnectionEstablishment: error_1.CDPConnectionEstablishmentError,
+                ConnectionBreak: error_1.CDPConnectionBreakError,
+                ConnectionTerminated: error_1.CDPConnectionTerminatedError,
+                ConnectionTimeout: error_1.CDPConnectionTimeoutError,
+                RequestTimeout: error_1.CDPRequestError,
+            },
+            onMessage: this._onMessage.bind(this),
+        });
+    }
+    /** @description Creates CDPConnection without establishing it */
+    static async create(browser) {
+        const sessionId = browser.publicAPI.sessionId;
+        const cdpWsEndpoint = await (0, ws_endpoint_1.getWsEndpoint)(browser);
+        const headers = browser.publicAPI.options?.headers ?? {};
+        if (!cdpWsEndpoint) {
+            throw new error_1.CDPError({ message: `Couldn't determine CDP endpoint for session ${sessionId}` });
+        }
+        return new this(cdpWsEndpoint, headers);
+    }
+    close() {
+        this._wsConnection.close();
+    }
+    _onMessage(data) {
+        const message = data.toString("utf8");
+        try {
+            const jsonParsedMessage = JSON.parse(message);
+            if (debug_1.debugCdp.enabled) {
+                (0, debug_1.debugCdp)(`< ${(0, node_util_1.inspect)(jsonParsedMessage, {
+                    depth: 3,
+                    maxStringLength: 150,
+                    breakLength: Infinity,
+                    compact: true,
+                })}`);
+            }
+            if (!("id" in jsonParsedMessage)) {
+                if (this.onEventMessage) {
+                    this.onEventMessage(jsonParsedMessage);
+                }
+                return;
+            }
+            const requestId = jsonParsedMessage.id;
+            if ("result" in jsonParsedMessage) {
+                this._wsConnection.provideResponseFor(requestId, jsonParsedMessage.result);
+            }
+            else if ("error" in jsonParsedMessage) {
+                this._wsConnection.provideResponseFor(requestId, new error_1.CDPRequestError({
+                    message: jsonParsedMessage.error.message,
+                    code: jsonParsedMessage.error.code,
+                    requestId,
+                }));
+            }
+            else {
+                this._wsConnection.provideResponseFor(requestId, new error_1.CDPRequestError({
+                    message: "Received malformed response without result",
+                    code: constants_2.WS_ERROR_CODE.MALFORMED_RESPONSE,
+                    requestId,
+                }));
+            }
+        }
+        catch (err) {
+            if (debug_1.debugCdp.enabled) {
+                (0, debug_1.debugCdp)(`\u2718 Couldn't process CDP message\n\tError: ${err}\n\tMessage: "${message}"`);
+            }
+            const requestId = (0, utils_1.extractRequestIdFromBrokenResponse)(message);
+            if (requestId) {
+                this._wsConnection.provideResponseFor(requestId, new error_1.CDPRequestError({
+                    message: "Received malformed response: response is invalid JSON",
+                    code: constants_2.WS_ERROR_CODE.MALFORMED_RESPONSE,
+                    requestId,
+                }));
+            }
+        }
+    }
+    /** @description Performs high-level CDP request with retries and timeouts */
+    async request(method, { params, sessionId } = {}) {
+        let result;
+        for (let retriesLeft = constants_1.CDP_REQUEST_RETRIES; retriesLeft >= 0; retriesLeft--) {
+            const id = this._wsConnection.getRequestId();
+            const requestMessage = JSON.stringify({ id, sessionId, method, params });
+            if (debug_1.debugCdp.enabled) {
+                (0, debug_1.debugCdp)(`> ${(0, node_util_1.inspect)(requestMessage, {
+                    depth: 3,
+                    maxStringLength: 150,
+                    breakLength: Infinity,
+                    compact: true,
+                })}`);
+            }
+            result = (await this._wsConnection.makeRequest(id, requestMessage));
+            if (!(result instanceof error_2.WsError) || !result.isRetryable() || retriesLeft <= 0) {
+                break;
+            }
+            if (debug_1.debugCdp.enabled) {
+                (0, debug_1.debugCdp)(`⟳ ${(0, node_util_1.inspect)({
+                    id,
+                    sessionId,
+                    method,
+                    params,
+                    errorMessage: result.message,
+                    retriesLeft: retriesLeft,
+                })}`);
+            }
+            // Intentionally avoiding wait after timeout
+            if (!(result instanceof error_1.CDPRequestTimeoutError)) {
+                await (0, utils_2.exponentiallyWait)({
+                    baseDelay: constants_1.CDP_REQUEST_RETRY_BASE_DELAY,
+                    attempt: constants_1.CDP_REQUEST_RETRIES - retriesLeft,
+                });
+            }
+        }
+        if (result instanceof error_2.WsError) {
+            throw result;
+        }
+        return result;
+    }
+}
+exports.CDPConnection = CDPConnection;
+//# sourceMappingURL=connection.js.map

package/build/src/browser/cdp/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../../src/browser/cdp/connection.ts"],"names":[],"mappings":";;;AACA,yCAAoC;AACpC,mCAAmC;AACnC,+CAA8C;AAC9C,mCAA6D;AAC7D,mCAQiB;AACjB,2CAOqB;AAGrB,uDAAmD;AACnD,6DAA8D;AAC9D,qDAAoD;AACpD,qDAA8D;AAI9D,MAAa,aAAa;IAKtB,YAAoB,aAAqB,EAAE,OAAgC;QAJpE,mBAAc,GAA4B,IAAI,CAAC;QAKlD,IAAI,CAAC,aAAa,GAAG,IAAI,4BAAY,CAAkC,aAAa,EAAE;YAClF,OAAO;YACP,OAAO,EAAE,gBAAQ;YACjB,OAAO,EAAE;gBACL,KAAK,EAAE,kCAAsB;gBAC7B,SAAS,EAAE,2CAA+B;aAC7C;YACD,QAAQ,EAAE;gBACN,OAAO,EAAE,+BAAmB;gBAC5B,aAAa,EAAE,kCAAsB;aACxC;YACD,MAAM,EAAE;gBACJ,uBAAuB,EAAE,uCAA+B;gBACxD,eAAe,EAAE,+BAAuB;gBACxC,oBAAoB,EAAE,oCAA4B;gBAClD,iBAAiB,EAAE,iCAAyB;gBAC5C,cAAc,EAAE,uBAAe;aAClC;YACD,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;SACxC,CAAC,CAAC;IACP,CAAC;IAED,iEAAiE;IACjE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAgB;QAChC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC;QAE9C,MAAM,aAAa,GAAG,MAAM,IAAA,2BAAa,EAAC,OAAO,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;QAEzD,IAAI,CAAC,aAAa,EAAE,CAAC;YACjB,MAAM,IAAI,gBAAQ,CAAC,EAAE,OAAO,EAAE,+CAA+C,SAAS,EAAE,EAAE,CAAC,CAAC;QAChG,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK;QACD,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAEO,UAAU,CAAC,IAAa;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEtC,IAAI,CAAC;YACD,MAAM,iBAAiB,GAAe,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAE1D,IAAI,gBAAQ,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAA,gBAAQ,EACJ,KAAK,IAAA,mBAAO,EAAC,iBAAiB,EAAE;oBAC5B,KAAK,EAAE,CAAC;oBACR,eAAe,EAAE,GAAG;oBACpB,WAAW,EAAE,QAAQ;oBACrB,OAAO,EAAE,IAAI;iBAChB,CAAC,EAAE,CACP,CAAC;YACN,CAAC;YAED,IAAI,CAAC,CAAC,IAAI,IAAI,iBAAiB,CAAC,EAAE,CAAC;gBAC/B,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBACtB,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;gBAC3C,CAAC;gBAED,OAAO;YACX,CAAC;YAED,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,CAAC;YAEvC,IAAI,QAAQ,IAAI,iBAAiB,EAAE,CAAC;gBAChC,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAC/E,CAAC;iBAAM,IAAI,OAAO,IAAI,iBAAiB,EAAE,CAAC;gBACtC,IAAI,CAAC,aAAa,CAAC,kBAAkB,CACjC,SAAS,EACT,IAAI,uBAAe,CAAC;oBAChB,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,OAAO;oBACxC,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,IAAI;oBAClC,SAAS;iBACZ,CAAC,CACL,CAAC;YACN,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,aAAa,CAAC,kBAAkB,CACjC,SAAS,EACT,IAAI,uBAAe,CAAC;oBAChB,OAAO,EAAE,4CAA4C;oBACrD,IAAI,EAAE,yBAAa,CAAC,kBAAkB;oBACtC,SAAS;iBACZ,CAAC,CACL,CAAC;YACN,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAI,gBAAQ,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAA,gBAAQ,EAAC,iDAAiD,GAAG,iBAAiB,OAAO,GAAG,CAAC,CAAC;YAC9F,CAAC;YAED,MAAM,SAAS,GAAG,IAAA,0CAAkC,EAAC,OAAO,CAAC,CAAC;YAE9D,IAAI,SAAS,EAAE,CAAC;gBACZ,IAAI,CAAC,aAAa,CAAC,kBAAkB,CACjC,SAAS,EACT,IAAI,uBAAe,CAAC;oBAChB,OAAO,EAAE,uDAAuD;oBAChE,IAAI,EAAE,yBAAa,CAAC,kBAAkB;oBACtC,SAAS;iBACZ,CAAC,CACL,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,OAAO,CACT,MAA4B,EAC5B,EAAE,MAAM,EAAE,SAAS,KAAwC,EAAE;QAE7D,IAAI,MAAoB,CAAC;QAEzB,KAAK,IAAI,WAAW,GAAG,+BAAmB,EAAE,WAAW,IAAI,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC;YAC1E,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;YAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAEzE,IAAI,gBAAQ,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAA,gBAAQ,EACJ,KAAK,IAAA,mBAAO,EAAC,cAAc,EAAE;oBACzB,KAAK,EAAE,CAAC;oBACR,eAAe,EAAE,GAAG;oBACpB,WAAW,EAAE,QAAQ;oBACrB,OAAO,EAAE,IAAI;iBAChB,CAAC,EAAE,CACP,CAAC;YACN,CAAC;YAED,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,EAAE,cAAc,CAAC,CAAgB,CAAC;YAEnF,IAAI,CAAC,CAAC,MAAM,YAAY,eAAO,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;gBAC5E,MAAM;YACV,CAAC;YAED,IAAI,gBAAQ,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAA,gBAAQ,EACJ,KAAK,IAAA,mBAAO,EAAC;oBACT,EAAE;oBACF,SAAS;oBACT,MAAM;oBACN,MAAM;oBACN,YAAY,EAAE,MAAM,CAAC,OAAO;oBAC5B,WAAW,EAAE,WAAW;iBAC3B,CAAC,EAAE,CACP,CAAC;YACN,CAAC;YAED,4CAA4C;YAC5C,IAAI,CAAC,CAAC,MAAM,YAAY,8BAAsB,CAAC,EAAE,CAAC;gBAC9C,MAAM,IAAA,yBAAiB,EAAC;oBACpB,SAAS,EAAE,wCAA4B;oBACvC,OAAO,EAAE,+BAAmB,GAAG,WAAW;iBAC7C,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QAED,IAAI,MAAM,YAAY,eAAO,EAAE,CAAC;YAC5B,MAAM,MAAM,CAAC;QACjB,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ;AA1KD,sCA0KC"}

package/build/src/browser/cdp/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const CDP_CONNECTION_TIMEOUT = 15000;
+export declare const CDP_CONNECTION_RETRIES = 3;
+export declare const CDP_CONNECTION_RETRY_BASE_DELAY = 500;
+export declare const CDP_REQUEST_TIMEOUT = 15000;
+export declare const CDP_REQUEST_RETRIES = 3;
+export declare const CDP_REQUEST_RETRY_BASE_DELAY = 500;

package/build/src/browser/cdp/constants.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CDP_REQUEST_RETRY_BASE_DELAY = exports.CDP_REQUEST_RETRIES = exports.CDP_REQUEST_TIMEOUT = exports.CDP_CONNECTION_RETRY_BASE_DELAY = exports.CDP_CONNECTION_RETRIES = exports.CDP_CONNECTION_TIMEOUT = void 0;
+exports.CDP_CONNECTION_TIMEOUT = 15000; // 15 sec
+exports.CDP_CONNECTION_RETRIES = 3;
+exports.CDP_CONNECTION_RETRY_BASE_DELAY = 500;
+exports.CDP_REQUEST_TIMEOUT = 15000; // 15 sec
+exports.CDP_REQUEST_RETRIES = 3;
+exports.CDP_REQUEST_RETRY_BASE_DELAY = 500;
+//# sourceMappingURL=constants.js.map

package/build/src/browser/cdp/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/browser/cdp/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,sBAAsB,GAAG,KAAK,CAAC,CAAC,SAAS;AACzC,QAAA,sBAAsB,GAAG,CAAC,CAAC;AAC3B,QAAA,+BAA+B,GAAG,GAAG,CAAC;AACtC,QAAA,mBAAmB,GAAG,KAAK,CAAC,CAAC,SAAS;AACtC,QAAA,mBAAmB,GAAG,CAAC,CAAC;AACxB,QAAA,4BAA4B,GAAG,GAAG,CAAC"}

package/build/src/browser/cdp/debug.d.ts

@@ -0,0 +1,2 @@
+import debugModule from "debug";
+export declare const debugCdp: debugModule.Debugger;

package/build/src/browser/cdp/debug.js

@@ -0,0 +1,9 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debugCdp = void 0;
+const debug_1 = __importDefault(require("debug"));
+exports.debugCdp = (0, debug_1.default)("testplane:cdp");
+//# sourceMappingURL=debug.js.map

package/build/src/browser/cdp/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../../../src/browser/cdp/debug.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAgC;AAEnB,QAAA,QAAQ,GAAG,IAAA,eAAW,EAAC,eAAe,CAAC,CAAC"}

package/build/src/browser/cdp/domains/css.d.ts

@@ -0,0 +1,54 @@
+import { CDPConnection } from "../connection";
+import { CDPEventEmitter } from "../emitter";
+import type { CDPCSSStyleSheetHeader, CDPSessionId, CDPStyleSheetId } from "../types";
+export interface CSSRuleUsage {
+    styleSheetId: CDPStyleSheetId;
+    startOffset: number;
+    endOffset: number;
+    used: boolean;
+}
+interface StopRuleUsageTrackingResponse {
+    ruleUsage: CSSRuleUsage[];
+}
+interface TakeCoverageDeltaResponse {
+    coverage: CSSRuleUsage[];
+    /** Monotonically increasing time, in seconds. */
+    timestamp: number;
+}
+export interface CssEvents {
+    fontsUpdated: {
+        font: Record<string, unknown>;
+    };
+    mediaQueryResultChanged: Record<string, never>;
+    styleSheetAdded: {
+        header: CDPCSSStyleSheetHeader;
+    };
+    styleSheetChanged: {
+        styleSheetId: CDPStyleSheetId;
+    };
+    styleSheetRemoved: {
+        styleSheetId: CDPStyleSheetId;
+    };
+}
+/** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/ */
+export declare class CDPCss extends CDPEventEmitter<CssEvents> {
+    private readonly _connection;
+    constructor(connection: CDPConnection);
+    /** @param sessionId result of "Target.attachToTarget" */
+    /** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/#method-enable */
+    enable(sessionId: CDPSessionId): Promise<void>;
+    /** @param sessionId result of "Target.attachToTarget" */
+    /** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/#method-disable */
+    disable(sessionId: CDPSessionId): Promise<void>;
+    /** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/#method-getStyleSheetText */
+    getStyleSheetText(sessionId: CDPSessionId, styleSheetId: CDPStyleSheetId): Promise<{
+        text: string;
+    }>;
+    /** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/#method-startRuleUsageTracking */
+    startRuleUsageTracking(sessionId: CDPSessionId): Promise<void>;
+    /** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/#method-stopRuleUsageTracking */
+    stopRuleUsageTracking(sessionId: CDPSessionId): Promise<StopRuleUsageTrackingResponse>;
+    /** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/#method-takeCoverageDelta */
+    takeCoverageDelta(sessionId: CDPSessionId): Promise<TakeCoverageDeltaResponse>;
+}
+export {};

package/build/src/browser/cdp/domains/css.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CDPCss = void 0;
+const emitter_1 = require("../emitter");
+/** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/ */
+class CDPCss extends emitter_1.CDPEventEmitter {
+    constructor(connection) {
+        super();
+        this._connection = connection;
+    }
+    /** @param sessionId result of "Target.attachToTarget" */
+    /** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/#method-enable */
+    async enable(sessionId) {
+        return this._connection.request("CSS.enable", { sessionId });
+    }
+    /** @param sessionId result of "Target.attachToTarget" */
+    /** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/#method-disable */
+    async disable(sessionId) {
+        return this._connection.request("CSS.disable", { sessionId });
+    }
+    /** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/#method-getStyleSheetText */
+    async getStyleSheetText(sessionId, styleSheetId) {
+        return this._connection.request("CSS.getStyleSheetText", { sessionId, params: { styleSheetId } });
+    }
+    /** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/#method-startRuleUsageTracking */
+    async startRuleUsageTracking(sessionId) {
+        return this._connection.request("CSS.startRuleUsageTracking", { sessionId });
+    }
+    /** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/#method-stopRuleUsageTracking */
+    async stopRuleUsageTracking(sessionId) {
+        return this._connection.request("CSS.stopRuleUsageTracking", { sessionId });
+    }
+    /** @link https://chromedevtools.github.io/devtools-protocol/tot/CSS/#method-takeCoverageDelta */
+    async takeCoverageDelta(sessionId) {
+        return this._connection.request("CSS.takeCoverageDelta", { sessionId });
+    }
+}
+exports.CDPCss = CDPCss;
+//# sourceMappingURL=css.js.map

package/build/src/browser/cdp/domains/css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.js","sourceRoot":"","sources":["../../../../../src/browser/cdp/domains/css.ts"],"names":[],"mappings":";;;AACA,wCAA6C;AAoC7C,wEAAwE;AACxE,MAAa,MAAO,SAAQ,yBAA0B;IAGlD,YAAmB,UAAyB;QACxC,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAClC,CAAC;IAED,yDAAyD;IACzD,sFAAsF;IACtF,KAAK,CAAC,MAAM,CAAC,SAAuB;QAChC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,yDAAyD;IACzD,uFAAuF;IACvF,KAAK,CAAC,OAAO,CAAC,SAAuB;QACjC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,iGAAiG;IACjG,KAAK,CAAC,iBAAiB,CAAC,SAAuB,EAAE,YAA6B;QAC1E,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;IACtG,CAAC;IAED,sGAAsG;IACtG,KAAK,CAAC,sBAAsB,CAAC,SAAuB;QAChD,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,qGAAqG;IACrG,KAAK,CAAC,qBAAqB,CAAC,SAAuB;QAC/C,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,2BAA2B,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,iGAAiG;IACjG,KAAK,CAAC,iBAAiB,CAAC,SAAuB;QAC3C,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5E,CAAC;CACJ;AAxCD,wBAwCC"}