@applitools/spec-driver-browser-extension 1.5.5 → 1.5.6

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [1.5.6](https://github.com/Applitools-Dev/sdk/compare/js/spec-driver-browser-extension@1.5.5...js/spec-driver-browser-extension@1.5.6) (2026-07-21)
+
+
+### Dependencies
+
+* @applitools/dom-shared bumped to 1.2.2
+  #### Bug Fixes
+
+  * CSP-safe sandbox opt-out for the MV3 extension content script | AD-14808 ([#3969](https://github.com/Applitools-Dev/sdk/issues/3969)) ([772aefa](https://github.com/Applitools-Dev/sdk/commit/772aefaa3e2bc1eb345fa8d3f6c91ad0913f82e7))
+* @applitools/snippets bumped to 2.9.4
+  #### Bug Fixes
+
+  * bound lazyLoad scroll loop to prevent poll-timeout abort | FLD-4680 ([#3972](https://github.com/Applitools-Dev/sdk/issues/3972)) ([4deea6b](https://github.com/Applitools-Dev/sdk/commit/4deea6b1f6f8ec53bd989cd6bbd021cac2ee3c1e))
+
+
+
+* @applitools/driver bumped to 1.26.6
+
+* @applitools/spec-driver-playwright bumped to 1.9.6
+
+
 ## [1.5.5](https://github.com/Applitools-Dev/sdk/compare/js/spec-driver-browser-extension@1.5.4...js/spec-driver-browser-extension@1.5.5) (2026-06-28)
 
 

package/dist/index.js

@@ -28,5 +28,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const spec = __importStar(require("./spec-driver"));
 __exportStar(require("./refer"), exports);
+__exportStar(require("./page-dispatch"), exports);
 __exportStar(require("./spec-driver"), exports);
 exports.default = spec;

package/dist/page-dispatch.js

@@ -0,0 +1,39 @@
+"use strict";
+// Page-world handlers the content script installs on `window.applitools`: resolve a snippet/poll by its
+// stable id and run it in the page that owns `refer`. See OVERVIEW.md for the dispatch rationale.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeRunPoll = exports.makeRunSnippet = void 0;
+// Returns an envelope instead of throwing: MV3 nulls in-page throws, losing the error signal.
+function makeRunSnippet({ snippetById, refer }) {
+    return function runSnippet(id, arg) {
+        const fn = snippetById.get(id);
+        if (!fn)
+            return { status: 'error', error: { name: 'SnippetNotFound', message: String(id) } };
+        try {
+            // Re-ref node returns too: the result is structured-cloned back, which skips Node.toJSON.
+            // Snippets are contractually SYNCHRONOUS: every @applitools/snippets export returns a value
+            // synchronously. `fn` is called and its return re-ref'd without awaiting, so a Promise-returning
+            // snippet would be ref'd as `{}` and drop its value. Any future async snippet must change this seam.
+            return { status: 'success', value: refer.ref(fn(refer.deref(arg))) };
+        }
+        catch (err) {
+            return { status: 'error', error: { name: err && err.name, message: err && err.message, stack: err && err.stack } };
+        }
+    };
+}
+exports.makeRunSnippet = makeRunSnippet;
+// A poll returns its own JSON-string envelope, so pass it back verbatim; catch throws into that shape.
+function makeRunPoll({ pollById, refer }) {
+    return function runPoll(id, arg) {
+        const fn = pollById.get(id);
+        if (!fn)
+            return JSON.stringify({ status: 'ERROR', error: 'poll fn not found: ' + id });
+        try {
+            return fn(refer.deref(arg));
+        }
+        catch (err) {
+            return JSON.stringify({ status: 'ERROR', error: err && err.message });
+        }
+    };
+}
+exports.makeRunPoll = makeRunPoll;

package/dist/refer.js

@@ -26,7 +26,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeRefer = void 0;
 const utils = __importStar(require("@applitools/utils"));
 const REF_ID = 'applitools-ref-id';
-function makeRefer({ check = (_arg) => true, validate = (_arg) => void 0 } = {}) {
+function makeRefer({ check = (_arg) => true, validate = (_arg) => void 0, } = {}) {
     const store = new Map();
     const shorthands = new Map();
     return { isRef, get, ref, deref };

package/dist/spec-driver.js

@@ -71,17 +71,66 @@ function extractContext(driver) {
     return { ...driver, frameId: 0 };
 }
 exports.extractContext = extractContext;
+// Re-throw an executeScript-level injection failure, preserving the original stack.
+function throwInjectionError(error) {
+    const err = new Error(error.message);
+    err.stack = error.stack;
+    throw err;
+}
 async function executeScript(context, script, arg) {
+    // Dispatch a stamped snippet by id through the page registry: executeScript structured-clones args
+    // (so the content-script deref reviver never fires), and the page returns a {status, value|error}
+    // envelope because MV3 nulls in-page throws.
+    const snippetName = typeof script === 'function' ? script.snippetName : undefined;
+    if (snippetName) {
+        const [{ result, error }] = await webextension_polyfill_1.default.scripting.executeScript({
+            target: { tabId: context.tabId, frameIds: [context.frameId || 0] },
+            func: (id, arg) => window.applitools.runSnippet(id, arg),
+            args: [snippetName, arg !== null && arg !== void 0 ? arg : null],
+        });
+        if (error)
+            throwInjectionError(error);
+        if (result && result.status === 'error') {
+            // Rebuild the error so isStaleElementError can match on `.message`.
+            const err = new Error(result.error.message);
+            err.name = result.error.name;
+            err.stack = result.error.stack;
+            throw err;
+        }
+        if (!result) {
+            // A falsy result is MV3 nulling an in-page throw (e.g. the registry isn't installed yet), never a
+            // real return — those arrive in a truthy success envelope. Make it recoverable so withRefresh retries.
+            throw new Error('StaleElementReferenceError');
+        }
+        if (result.status === 'success')
+            return result.value;
+        throw new Error(`runSnippet returned a malformed envelope: ${JSON.stringify(result)}`);
+    }
+    // Same dispatch for dom-snapshot polls, but the poll already returns its own JSON-string envelope, so
+    // pass it back verbatim — no {status, value} wrapping.
+    const pollName = typeof script === 'function' ? script.pollName : undefined;
+    if (pollName) {
+        const [{ result, error }] = await webextension_polyfill_1.default.scripting.executeScript({
+            target: { tabId: context.tabId, frameIds: [context.frameId || 0] },
+            func: (id, arg) => window.applitools.runPoll(id, arg),
+            args: [pollName, arg !== null && arg !== void 0 ? arg : null],
+        });
+        if (error)
+            throwInjectionError(error);
+        if (!result) {
+            // A falsy result is MV3 nulling an in-page throw (e.g. the registry isn't installed yet), never a
+            // real return — runPoll always yields a truthy JSON-string envelope. Make it recoverable so withRefresh retries.
+            throw new Error('StaleElementReferenceError');
+        }
+        return result;
+    }
     const [{ result, error }] = await webextension_polyfill_1.default.scripting.executeScript({
         target: { tabId: context.tabId, frameIds: [context.frameId || 0] },
         func: script,
-        args: [arg || null],
+        args: [arg !== null && arg !== void 0 ? arg : null],
     });
-    if (error) {
-        const err = new Error(error.message);
-        err.stack = error.stack;
-        throw err;
-    }
+    if (error)
+        throwInjectionError(error);
     return result;
 }
 exports.executeScript = executeScript;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applitools/spec-driver-browser-extension",
-  "version": "1.5.5",
+  "version": "1.5.6",
   "keywords": [
     "playwright",
     "chrome devtools protocol",
@@ -40,14 +40,14 @@
     "playwright:setup": "yarn playwright install --with-deps chromium"
   },
   "dependencies": {
-    "@applitools/driver": "1.26.5",
+    "@applitools/driver": "1.26.6",
     "@applitools/utils": "1.15.1",
     "webextension-polyfill": "0.10.0"
   },
   "devDependencies": {
     "@applitools/api-extractor": "^1.2.22",
     "@applitools/logger": "^2.3.0",
-    "@applitools/spec-driver-playwright": "^1.9.5",
+    "@applitools/spec-driver-playwright": "^1.9.6",
     "@applitools/test-utils": "^1.5.17",
     "@babel/core": "^7.26.0",
     "@babel/preset-env": "^7.22.5",

package/types/index.d.ts

@@ -1,4 +1,5 @@
 import * as spec from './spec-driver';
 export * from './refer';
+export * from './page-dispatch';
 export * from './spec-driver';
 export default spec;

package/types/page-dispatch.d.ts

@@ -0,0 +1,18 @@
+type Refer = {
+    ref(value: any): any;
+    deref(ref: any): any;
+};
+type PageFn = (arg: any) => any;
+export declare function makeRunSnippet({ snippetById, refer }: {
+    snippetById: Map<string, PageFn>;
+    refer: Refer;
+}): (id: string, arg: any) => {
+    status: 'success' | 'error';
+    value?: any;
+    error?: any;
+};
+export declare function makeRunPoll({ pollById, refer }: {
+    pollById: Map<string, PageFn>;
+    refer: Refer;
+}): (id: string, arg: any) => string;
+export {};

package/types/refer.d.ts

@@ -1,6 +1,6 @@
-export declare function makeRefer({ check, validate }?: {
-    check?: ((_arg: any) => true) | undefined;
-    validate?: ((_arg: any) => undefined) | undefined;
+export declare function makeRefer({ check, validate, }?: {
+    check?: (value: any) => boolean;
+    validate?: (value: any) => void;
 }): {
     isRef: (ref: any) => boolean;
     get: (key: any) => any;