@xingular/harness 1.0.0 → 1.2.0

package/dist/sdk/annotations/isolated.js

@@ -0,0 +1,51 @@
+const WORLD = 'harness-page-notes';
+const worlds = new WeakMap();
+const watched = new WeakSet();
+async function createWorld(page) {
+    const cdp = await page.context().newCDPSession(page);
+    const { frameTree } = await cdp.send('Page.getFrameTree');
+    const { executionContextId } = await cdp.send('Page.createIsolatedWorld', { frameId: frameTree.frame.id, worldName: WORLD, grantUniveralAccess: false });
+    const world = { cdp, contextId: executionContextId };
+    worlds.set(page, world);
+    if (!watched.has(page)) {
+        watched.add(page);
+        // A new document destroys the world; the next call makes another.
+        page.on('framenavigated', (frame) => {
+            if (frame !== page.mainFrame())
+                return;
+            const old = worlds.get(page);
+            worlds.delete(page);
+            void old?.cdp.detach().catch(() => undefined);
+        });
+    }
+    return world;
+}
+/** Evaluates `expression` (which yields a JSON string) and says whether the page could have reached it. */
+export async function evaluateIsolated(page, expression) {
+    if (typeof page.context !== 'function' || typeof page.context().newCDPSession !== 'function') {
+        return { reply: await page.evaluate(expression), trusted: false };
+    }
+    let lastError = null;
+    for (let attempt = 0; attempt < 2; attempt++) {
+        let world = worlds.get(page) ?? null;
+        try {
+            world ??= await createWorld(page);
+            const evaluated = await world.cdp.send('Runtime.evaluate', { expression, contextId: world.contextId, returnByValue: true, awaitPromise: false });
+            if (evaluated.exceptionDetails)
+                throw new Error(evaluated.exceptionDetails.text || 'The page helper failed.');
+            return { reply: evaluated.result?.value, trusted: true };
+        }
+        catch (error) {
+            lastError = error;
+            worlds.delete(page);
+            void world?.cdp.detach().catch(() => undefined);
+            // A context that went away with a navigation is made again once; anything else falls back.
+            if (attempt === 0 && /context|target closed|detached/i.test(String(error)))
+                continue;
+            break;
+        }
+    }
+    if (/closed/i.test(String(lastError)))
+        throw lastError;
+    return { reply: await page.evaluate(expression), trusted: false };
+}

package/dist/sdk/annotations/pageScript.d.ts

@@ -0,0 +1,28 @@
+/** The helper's source. `__ARGS__` is replaced with one JSON operation; the expression evaluates to a JSON string. */
+export declare const PAGE_SCRIPT: string;
+export type PageOperation = {
+    operation: 'identity';
+} | {
+    operation: 'begin';
+    kind: 'text' | 'element' | 'inspect';
+    captureId: string;
+} | {
+    operation: 'capture';
+    captureId: string;
+} | {
+    operation: 'next';
+    captureId: string;
+} | {
+    operation: 'toast';
+    text: string;
+} | {
+    operation: 'cancel';
+    captureId?: string;
+} | {
+    operation: 'resolve' | 'reveal';
+    target: unknown;
+};
+/** The expression to evaluate in the page for one operation. */
+export declare function pageCall(operation: PageOperation): string;
+/** Reads the helper's reply, throwing its error. */
+export declare function pageReply<T>(reply: unknown): T;