@testivai/witness-playwright 1.5.1 → 1.5.2

package/dist/capture/element-map.d.ts

@@ -27,11 +27,11 @@ export interface CollectedElement {
  * - `styleHash` digests a fixed, documented list of computed properties
  *   (FNV-1a 32-bit, hex) — deterministic for identical rendering.
  */
-export declare function collectElementMap(doc: Document, win: Window & typeof globalThis, maxElements: number): CollectedElement[];
+export declare function collectElementMap(doc: Document, win: Window & typeof globalThis, maxElements: number, ignoreSelectors?: string[]): CollectedElement[];
 /** Default element cap — bounds capture time and elements.json size. */
 export declare const DEFAULT_MAX_ELEMENTS = 3000;
 /**
  * The page-side expression evaluated by the adapter. Serializes the
  * collector so page code and unit-tested code are the same function.
  */
-export declare function buildElementMapExpression(maxElements?: number): string;
+export declare function buildElementMapExpression(maxElements?: number, ignoreSelectors?: string[]): string;

package/dist/capture/element-map.js

@@ -24,7 +24,7 @@ exports.buildElementMapExpression = buildElementMapExpression;
  * - `styleHash` digests a fixed, documented list of computed properties
  *   (FNV-1a 32-bit, hex) — deterministic for identical rendering.
  */
-function collectElementMap(doc, win, maxElements) {
+function collectElementMap(doc, win, maxElements, ignoreSelectors = []) {
     var STYLE_PROPS = [
         'color', 'background-color', 'background-image',
         'border-top-color', 'border-right-color', 'border-bottom-color', 'border-left-color',
@@ -84,26 +84,55 @@ function collectElementMap(doc, win, maxElements) {
     var stack = [body];
     while (stack.length > 0 && out.length < maxElements) {
         var el = stack.pop();
+        // The consistency rule: elements covered by ignoreSelectors are
+        // excluded from pixels and the DOM snapshot — they must be excluded
+        // from the element map too (subtree included), or their dynamic
+        // styles would trip the style fingerprint they were meant to escape.
+        var ignored = false;
+        if (ignoreSelectors.length > 0 && typeof el.matches === 'function') {
+            for (var g = 0; g < ignoreSelectors.length; g++) {
+                try {
+                    if (el.matches(ignoreSelectors[g])) {
+                        ignored = true;
+                        break;
+                    }
+                }
+                catch (e) {
+                    // invalid selector — never breaks the walk
+                }
+            }
+        }
+        if (ignored)
+            continue; // skip element AND subtree
         var rect = el.getBoundingClientRect();
         if (rect.width >= 4 && rect.height >= 4) {
             var styleParts = [];
+            var hidden = false;
             try {
                 var cs = win.getComputedStyle(el);
                 for (var p = 0; p < STYLE_PROPS.length; p++) {
-                    styleParts.push(STYLE_PROPS[p] + ':' + cs.getPropertyValue(STYLE_PROPS[p]));
+                    var value = cs.getPropertyValue(STYLE_PROPS[p]);
+                    if (STYLE_PROPS[p] === 'visibility' && value === 'hidden')
+                        hidden = true;
+                    styleParts.push(STYLE_PROPS[p] + ':' + value);
                 }
             }
             catch (e) {
                 // styleHash stays a digest of the empty string — still deterministic
             }
-            out.push({
-                path: pathOf(el, body),
-                x: Math.round((rect.x + scrollX) * dpr),
-                y: Math.round((rect.y + scrollY) * dpr),
-                width: Math.round(rect.width * dpr),
-                height: Math.round(rect.height * dpr),
-                styleHash: fnv1a(styleParts.join(';')),
-            });
+            // visibility:hidden elements paint no pixels, so their style changes
+            // can never explain a pixel diff — keep them out of the map. Their
+            // CHILDREN may override visibility, so the subtree still walks.
+            if (!hidden) {
+                out.push({
+                    path: pathOf(el, body),
+                    x: Math.round((rect.x + scrollX) * dpr),
+                    y: Math.round((rect.y + scrollY) * dpr),
+                    width: Math.round(rect.width * dpr),
+                    height: Math.round(rect.height * dpr),
+                    styleHash: fnv1a(styleParts.join(';')),
+                });
+            }
         }
         // Push children in reverse so the walk stays document-ordered
         for (var c = el.children.length - 1; c >= 0; c--) {
@@ -118,6 +147,6 @@ exports.DEFAULT_MAX_ELEMENTS = 3000;
  * The page-side expression evaluated by the adapter. Serializes the
  * collector so page code and unit-tested code are the same function.
  */
-function buildElementMapExpression(maxElements = exports.DEFAULT_MAX_ELEMENTS) {
-    return `(${collectElementMap.toString()})(document, window, ${maxElements})`;
+function buildElementMapExpression(maxElements = exports.DEFAULT_MAX_ELEMENTS, ignoreSelectors = []) {
+    return `(${collectElementMap.toString()})(document, window, ${maxElements}, ${JSON.stringify(ignoreSelectors)})`;
 }

package/dist/snapshot.js

@@ -469,7 +469,8 @@ async function snapshot(page, testInfo, name, config) {
         // shift classification, and the style fingerprint on the compare
         // side. Best-effort — the screenshot path never depends on it.
         try {
-            const elementMap = await page.evaluate((0, element_map_1.buildElementMapExpression)());
+            const mapIgnores = (0, ignore_selectors_1.collectIgnoreSelectors)(process.cwd(), projectConfig, effectiveConfig);
+            const elementMap = await page.evaluate((0, element_map_1.buildElementMapExpression)(undefined, mapIgnores));
             if (Array.isArray(elementMap) && elementMap.length > 0) {
                 await fs.writeJson(path.join(localSnapshotDir, 'elements.json'), elementMap);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testivai/witness-playwright",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "description": "Playwright sensor for Testivai Visual Regression Test system",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",