@roxybrowser/playwright 2.0.2-beta.0

package/dist/screenshotOptions.js

@@ -0,0 +1,171 @@
+import { extname } from "node:path";
+export function determineScreenshotType(options) {
+    if (options.type) {
+        return options.type;
+    }
+    if (!options.path) {
+        return undefined;
+    }
+    const mimeType = getMimeTypeForPath(options.path);
+    if (mimeType === "image/png") {
+        return "png";
+    }
+    if (mimeType === "image/jpeg") {
+        return "jpeg";
+    }
+    throw new Error(`path: unsupported mime type "${mimeType}"`);
+}
+export function validateScreenshotOptions(options) {
+    const format = options.type ?? "png";
+    if (format !== "png" && format !== "jpeg") {
+        throw new Error(`Unknown options.type value: ${format}`);
+    }
+    if (options.quality !== undefined) {
+        if (format !== "jpeg") {
+            throw new Error(`options.quality is unsupported for the ${format} screenshots`);
+        }
+        if (typeof options.quality !== "number") {
+            throw new Error(`Expected options.quality to be a number but found ${typeof options.quality}`);
+        }
+        if (!Number.isInteger(options.quality)) {
+            throw new Error("Expected options.quality to be an integer");
+        }
+        if (options.quality < 0 || options.quality > 100) {
+            throw new Error(`Expected options.quality to be between 0 and 100 (inclusive), got ${options.quality}`);
+        }
+    }
+    if (options.clip) {
+        validateClip(options.clip);
+    }
+    return format;
+}
+export function trimClipToSize(clip, size) {
+    const p1 = {
+        x: Math.max(0, Math.min(clip.x, size.width)),
+        y: Math.max(0, Math.min(clip.y, size.height))
+    };
+    const p2 = {
+        x: Math.max(0, Math.min(clip.x + clip.width, size.width)),
+        y: Math.max(0, Math.min(clip.y + clip.height, size.height))
+    };
+    const result = { x: p1.x, y: p1.y, width: p2.x - p1.x, height: p2.y - p1.y };
+    if (!result.width || !result.height) {
+        throw new Error("Clipped area is either empty or outside the resulting image");
+    }
+    return result;
+}
+export async function normalizePageScreenshotOptions(options, page, clipOrigin = "document") {
+    const screenshotOptions = { ...options };
+    const viewportSize = page.viewportSize()
+        ?? await page.evaluate(() => ({ width: window.innerWidth, height: window.innerHeight }));
+    if (options.fullPage) {
+        const evaluatedFullPageSize = await page.evaluate(() => {
+            if (!document.body || !document.documentElement) {
+                return { width: window.innerWidth, height: window.innerHeight };
+            }
+            return {
+                width: Math.max(document.body.scrollWidth, document.documentElement.scrollWidth, document.body.offsetWidth, document.documentElement.offsetWidth, document.body.clientWidth, document.documentElement.clientWidth),
+                height: Math.max(document.body.scrollHeight, document.documentElement.scrollHeight, document.body.offsetHeight, document.documentElement.offsetHeight, document.body.clientHeight, document.documentElement.clientHeight)
+            };
+        });
+        const fullPageSize = isSize(evaluatedFullPageSize) ? evaluatedFullPageSize : viewportSize;
+        const fitsViewport = fullPageSize.width <= viewportSize.width && fullPageSize.height <= viewportSize.height;
+        screenshotOptions.clip = options.clip
+            ? trimClipToSize(options.clip, fullPageSize)
+            : { x: 0, y: 0, width: fullPageSize.width, height: fullPageSize.height };
+        screenshotOptions.__fitsViewport = fitsViewport;
+        return { fitsViewport, options: screenshotOptions };
+    }
+    const viewportClip = options.clip
+        ? trimClipToSize(options.clip, viewportSize)
+        : { x: 0, y: 0, width: viewportSize.width, height: viewportSize.height };
+    const scrollOffset = clipOrigin === "document"
+        ? await page.evaluate(() => ({ x: window.scrollX, y: window.scrollY }))
+        : { x: 0, y: 0 };
+    const normalizedScrollOffset = isPoint(scrollOffset) ? scrollOffset : { x: 0, y: 0 };
+    screenshotOptions.clip = {
+        x: normalizedScrollOffset.x + viewportClip.x,
+        y: normalizedScrollOffset.y + viewportClip.y,
+        width: viewportClip.width,
+        height: viewportClip.height
+    };
+    screenshotOptions.__fitsViewport = true;
+    return { fitsViewport: true, options: screenshotOptions };
+}
+export function screenshotOptionsWithFitsViewport(options, fitsViewport) {
+    return {
+        ...options,
+        __fitsViewport: fitsViewport
+    };
+}
+export async function normalizeElementScreenshotClip(box, element, clipOrigin = "document") {
+    const scrollOffset = clipOrigin === "document"
+        ? await element.evaluate(() => ({ x: window.scrollX, y: window.scrollY }))
+        : { x: 0, y: 0 };
+    const normalizedScrollOffset = isPoint(scrollOffset) ? scrollOffset : { x: 0, y: 0 };
+    return enclosingIntRect({
+        x: box.x + normalizedScrollOffset.x,
+        y: box.y + normalizedScrollOffset.y,
+        width: box.width,
+        height: box.height
+    });
+}
+export function enclosingIntRect(rect) {
+    const x = Math.floor(rect.x);
+    const y = Math.floor(rect.y);
+    const right = Math.ceil(rect.x + rect.width);
+    const bottom = Math.ceil(rect.y + rect.height);
+    return {
+        x,
+        y,
+        width: right - x,
+        height: bottom - y
+    };
+}
+function isPoint(value) {
+    return Boolean(value &&
+        typeof value === "object" &&
+        typeof value.x === "number" &&
+        typeof value.y === "number");
+}
+function isSize(value) {
+    return Boolean(value &&
+        typeof value === "object" &&
+        typeof value.width === "number" &&
+        typeof value.height === "number");
+}
+function validateClip(clip) {
+    if (typeof clip.x !== "number") {
+        throw new Error(`Expected options.clip.x to be a number but found ${typeof clip.x}`);
+    }
+    if (typeof clip.y !== "number") {
+        throw new Error(`Expected options.clip.y to be a number but found ${typeof clip.y}`);
+    }
+    if (typeof clip.width !== "number") {
+        throw new Error(`Expected options.clip.width to be a number but found ${typeof clip.width}`);
+    }
+    if (typeof clip.height !== "number") {
+        throw new Error(`Expected options.clip.height to be a number but found ${typeof clip.height}`);
+    }
+    if (clip.width === 0) {
+        throw new Error("Expected options.clip.width not to be 0.");
+    }
+    if (clip.height === 0) {
+        throw new Error("Expected options.clip.height not to be 0.");
+    }
+}
+function getMimeTypeForPath(path) {
+    const extension = extname(path).toLowerCase();
+    switch (extension) {
+        case ".png":
+            return "image/png";
+        case ".jpg":
+        case ".jpeg":
+            return "image/jpeg";
+        case ".txt":
+            return "text/plain";
+        default:
+            return "application/octet-stream";
+    }
+}
+//# sourceMappingURL=screenshotOptions.js.map

package/dist/screenshotOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshotOptions.js","sourceRoot":"","sources":["../src/screenshotOptions.ts"],"names":[],"mappings":"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"}

package/dist/screenshotPreparation.d.ts

@@ -0,0 +1,21 @@
+import type { ScreenshotOptions, ViewportSize } from "./types/options.js";
+declare global {
+    interface Window {
+        __pwCleanupScreenshot?: () => void;
+    }
+}
+export interface ScreenshotEvaluationTarget {
+    evaluate<R, Arg>(pageFunction: ((arg: Arg) => R | Promise<R>) | string, arg: Arg): Promise<R>;
+}
+export interface ScreenshotPageTarget {
+    frames(): ScreenshotEvaluationTarget[];
+    viewportSize(): ViewportSize | null;
+}
+type ScreenshotPreparationOptions = Pick<ScreenshotOptions, "animations" | "caret" | "style">;
+type ScreenshotMaskOptions = Pick<ScreenshotOptions, "mask" | "maskColor">;
+export declare function preparePageForScreenshot(page: ScreenshotPageTarget, options: ScreenshotPreparationOptions & ScreenshotMaskOptions): Promise<() => Promise<void>>;
+export declare function prepareElementDocumentForScreenshot(element: {
+    evaluate<R, Arg>(pageFunction: (element: unknown, arg: Arg) => R | Promise<R>, arg: Arg): Promise<R>;
+}, options: ScreenshotPreparationOptions): Promise<() => Promise<void>>;
+export {};
+//# sourceMappingURL=screenshotPreparation.d.ts.map

package/dist/screenshotPreparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshotPreparation.d.ts","sourceRoot":"","sources":["../src/screenshotPreparation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAQ,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,qBAAqB,CAAC,EAAE,MAAM,IAAI,CAAC;KACpC;CACF;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC/F;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,IAAI,0BAA0B,EAAE,CAAC;IACvC,YAAY,IAAI,YAAY,GAAG,IAAI,CAAC;CACrC;AAED,KAAK,4BAA4B,GAAG,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC;AAC9F,KAAK,qBAAqB,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC;AAU3E,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,4BAA4B,GAAG,qBAAqB,GAC5D,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAW9B;AAED,wBAAsB,mCAAmC,CACvD,OAAO,EAAE;IAAE,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAAE,EACjH,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAiB9B"}

package/dist/screenshotPreparation.js

@@ -0,0 +1,199 @@
+export async function preparePageForScreenshot(page, options) {
+    const payload = createScreenshotPreparationPayload(options);
+    const frames = page.frames();
+    await Promise.all(frames.map((frame) => prepareFrameForScreenshot(frame, payload)));
+    const cleanupMasks = await maskElements(options);
+    return async () => {
+        await Promise.all([
+            cleanupMasks(),
+            ...frames.map((frame) => restoreFrameAfterScreenshot(frame))
+        ]);
+    };
+}
+export async function prepareElementDocumentForScreenshot(element, options) {
+    const payload = createScreenshotPreparationPayload(options);
+    await element.evaluate((_element, payload) => {
+        const prepare = globalThis.eval(`(${payload.prepareSource})`);
+        prepare(payload.screenshotStyle, payload.hideCaret, payload.disableAnimations, payload.syncAnimations);
+    }, payload);
+    return async () => {
+        await element.evaluate(() => {
+            window.__pwCleanupScreenshot && window.__pwCleanupScreenshot();
+        }, undefined).catch(() => { });
+    };
+}
+async function maskElements(options) {
+    if (!options.mask?.length) {
+        return async () => { };
+    }
+    const cleanups = [];
+    try {
+        for (const locator of options.mask) {
+            const handle = await locator.elementHandle({ timeout: 0 }).catch(() => null);
+            const box = await handle?.boundingBox().catch(() => null);
+            if (!handle || !box) {
+                continue;
+            }
+            await maskElement(handle, box, options.maskColor ?? "#F0F");
+            cleanups.push(async () => {
+                await handle.evaluate(() => {
+                    document.querySelectorAll("[data-roxy-screenshot-mask]").forEach((node) => node.remove());
+                }).catch(() => { });
+            });
+        }
+        return async () => {
+            await Promise.all(cleanups.map((cleanup) => cleanup()));
+        };
+    }
+    catch (error) {
+        await Promise.all(cleanups.map((cleanup) => cleanup().catch(() => { })));
+        throw error;
+    }
+}
+async function maskElement(handle, box, color) {
+    await handle.evaluate((_element, payload) => {
+        const overlay = document.createElement("div");
+        overlay.setAttribute("data-roxy-screenshot-mask", "true");
+        Object.assign(overlay.style, {
+            position: "fixed",
+            left: `${payload.box.x}px`,
+            top: `${payload.box.y}px`,
+            width: `${payload.box.width}px`,
+            height: `${payload.box.height}px`,
+            background: payload.color,
+            pointerEvents: "none",
+            zIndex: "2147483647"
+        });
+        document.documentElement.append(overlay);
+    }, { box, color });
+}
+async function prepareFrameForScreenshot(frame, payload) {
+    await frame.evaluate((framePayload) => {
+        const prepare = globalThis.eval(`(${framePayload.prepareSource})`);
+        prepare(framePayload.screenshotStyle, framePayload.hideCaret, framePayload.disableAnimations, framePayload.syncAnimations);
+    }, payload).catch(() => { });
+}
+async function restoreFrameAfterScreenshot(frame) {
+    await frame.evaluate(() => {
+        window.__pwCleanupScreenshot && window.__pwCleanupScreenshot();
+    }, undefined).catch(() => { });
+}
+function createScreenshotPreparationPayload(options) {
+    return {
+        disableAnimations: options.animations === "disabled",
+        hideCaret: options.caret !== "initial",
+        prepareSource: inPagePrepareForScreenshots.toString(),
+        screenshotStyle: options.style ?? "",
+        syncAnimations: false
+    };
+}
+function inPagePrepareForScreenshots(screenshotStyle, hideCaret, disableAnimations, syncAnimations) {
+    if (syncAnimations) {
+        const style = document.createElement("style");
+        style.textContent = "body {}";
+        document.head.appendChild(style);
+        document.documentElement.getBoundingClientRect();
+        style.remove();
+    }
+    if (!screenshotStyle && !hideCaret && !disableAnimations) {
+        return;
+    }
+    const collectRoots = (root, roots = []) => {
+        roots.push(root);
+        const walker = document.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
+        do {
+            const node = walker.currentNode;
+            const shadowRoot = node instanceof Element ? node.shadowRoot : null;
+            if (shadowRoot) {
+                collectRoots(shadowRoot, roots);
+            }
+        } while (walker.nextNode());
+        return roots;
+    };
+    const roots = collectRoots(document);
+    const cleanupCallbacks = [];
+    if (screenshotStyle) {
+        for (const root of roots) {
+            const styleTag = document.createElement("style");
+            styleTag.textContent = screenshotStyle;
+            if (root === document) {
+                document.documentElement.append(styleTag);
+            }
+            else {
+                root.append(styleTag);
+            }
+            cleanupCallbacks.push(() => {
+                styleTag.remove();
+            });
+        }
+    }
+    if (hideCaret) {
+        const elements = new Map();
+        for (const root of roots) {
+            root.querySelectorAll("input,textarea,[contenteditable]").forEach((element) => {
+                elements.set(element, {
+                    value: element.style.getPropertyValue("caret-color"),
+                    priority: element.style.getPropertyPriority("caret-color")
+                });
+                element.style.setProperty("caret-color", "transparent", "important");
+            });
+        }
+        cleanupCallbacks.push(() => {
+            for (const [element, value] of elements) {
+                element.style.setProperty("caret-color", value.value, value.priority);
+            }
+        });
+    }
+    if (disableAnimations) {
+        const infiniteAnimationsToResume = new Set();
+        const handleAnimations = (root) => {
+            for (const animation of root.getAnimations()) {
+                if (!animation.effect || animation.playbackRate === 0 || infiniteAnimationsToResume.has(animation)) {
+                    continue;
+                }
+                const endTime = animation.effect.getComputedTiming().endTime;
+                if (Number.isFinite(endTime)) {
+                    try {
+                        animation.finish();
+                    }
+                    catch {
+                    }
+                }
+                else {
+                    try {
+                        animation.cancel();
+                        infiniteAnimationsToResume.add(animation);
+                    }
+                    catch {
+                    }
+                }
+            }
+        };
+        for (const root of roots) {
+            const handleRootAnimations = handleAnimations.bind(null, root);
+            handleRootAnimations();
+            root.addEventListener("transitionrun", handleRootAnimations);
+            root.addEventListener("animationstart", handleRootAnimations);
+            cleanupCallbacks.push(() => {
+                root.removeEventListener("transitionrun", handleRootAnimations);
+                root.removeEventListener("animationstart", handleRootAnimations);
+            });
+        }
+        cleanupCallbacks.push(() => {
+            for (const animation of infiniteAnimationsToResume) {
+                try {
+                    animation.play();
+                }
+                catch {
+                }
+            }
+        });
+    }
+    window.__pwCleanupScreenshot = () => {
+        for (const cleanupCallback of cleanupCallbacks) {
+            cleanupCallback();
+        }
+        delete window.__pwCleanupScreenshot;
+    };
+}
+//# sourceMappingURL=screenshotPreparation.js.map

package/dist/screenshotPreparation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshotPreparation.js","sourceRoot":"","sources":["../src/screenshotPreparation.ts"],"names":[],"mappings":"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"}

package/dist/selectOptionValues.d.ts

@@ -0,0 +1,10 @@
+import type { ElementHandle } from "./types/api.js";
+import type { SelectOptionValue } from "./types/options.js";
+export type SelectOptionInput = null | string | SelectOptionValue | ElementHandle | ReadonlyArray<string | SelectOptionValue | ElementHandle | null>;
+export type NormalizedSelectOption = {
+    index?: number;
+    label?: string;
+    value?: string;
+};
+export declare function normalizeSelectOptionValues(select: ElementHandle, values: SelectOptionInput): Promise<NormalizedSelectOption[]>;
+//# sourceMappingURL=selectOptionValues.d.ts.map

package/dist/selectOptionValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectOptionValues.d.ts","sourceRoot":"","sources":["../src/selectOptionValues.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,MAAM,iBAAiB,GACzB,IAAI,GACJ,MAAM,GACN,iBAAiB,GACjB,aAAa,GACb,aAAa,CAAC,MAAM,GAAG,iBAAiB,GAAG,aAAa,GAAG,IAAI,CAAC,CAAC;AAErE,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAgCnC"}

package/dist/selectOptionValues.js

@@ -0,0 +1,60 @@
+import { RoxyElementHandle } from "./elementHandle.js";
+export async function normalizeSelectOptionValues(select, values) {
+    if (values === null) {
+        return [];
+    }
+    const entries = Array.isArray(values) ? values : [values];
+    const normalized = [];
+    for (let index = 0; index < entries.length; index++) {
+        const entry = entries[index];
+        const prefix = `options[${index}]`;
+        if (entry instanceof RoxyElementHandle) {
+            const optionIndex = await select.evaluate((selectElement, optionElement) => {
+                if (!(selectElement instanceof HTMLSelectElement)) {
+                    throw new Error("Element is not a <select> element.");
+                }
+                if (!(optionElement instanceof HTMLOptionElement)) {
+                    throw new Error("Element is not an <option> element.");
+                }
+                return Array.from(selectElement.options).indexOf(optionElement);
+            }, entry);
+            if (optionIndex === -1) {
+                throw new Error("Option element is not in the <select> element.");
+            }
+            normalized.push({ index: optionIndex });
+            continue;
+        }
+        normalized.push(normalizeSelectOptionValue(entry, prefix));
+    }
+    return normalized;
+}
+function normalizeSelectOptionValue(value, prefix) {
+    if (typeof value === "string") {
+        return { value };
+    }
+    if (!value || typeof value !== "object") {
+        throw new Error(`${prefix}: expected object, got ${value === null ? "null" : typeof value}`);
+    }
+    const candidate = value;
+    const normalized = {};
+    if (candidate.value !== undefined) {
+        if (typeof candidate.value !== "string") {
+            throw new Error(`${prefix}.value: expected string, got ${typeof candidate.value}`);
+        }
+        normalized.value = candidate.value;
+    }
+    if (candidate.label !== undefined) {
+        if (typeof candidate.label !== "string") {
+            throw new Error(`${prefix}.label: expected string, got ${typeof candidate.label}`);
+        }
+        normalized.label = candidate.label;
+    }
+    if (candidate.index !== undefined) {
+        if (typeof candidate.index !== "number" || !Number.isInteger(candidate.index)) {
+            throw new Error(`${prefix}.index: expected integer, got ${typeof candidate.index}`);
+        }
+        normalized.index = candidate.index;
+    }
+    return normalized;
+}
+//# sourceMappingURL=selectOptionValues.js.map

package/dist/selectOptionValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectOptionValues.js","sourceRoot":"","sources":["../src/selectOptionValues.ts"],"names":[],"mappings":"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"}

package/dist/selectors.d.ts

@@ -0,0 +1,3 @@
+import type { LocatorSelector } from "./protocol/adapter.js";
+export declare function parseSelectorChain(selector: string): LocatorSelector[];
+//# sourceMappingURL=selectors.d.ts.map

package/dist/selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAsBtE"}