@testivai/witness-playwright 1.1.5 → 1.2.0

package/dist/snapshot.js

@@ -94,6 +94,32 @@ async function snapshot(page, testInfo, name, config) {
     const baseFilename = `${timestamp}_${safeName}`;
     // 1. Capture full-page screenshot
     const screenshotPath = path.join(outputDir, `${baseFilename}.png`);
+    // In local mode: hide elements matching ignoreSelectors before the screenshot
+    // so dynamic content (version badges, timestamps, ads) doesn't cause false diffs.
+    // Sources (merged, deduped):
+    //   1. .testivai/config.json  → ignoreSelectors  (global, OSS config)
+    //   2. testivai.config.ts     → ignoreSelectors  (global, power users)
+    //   3. testivai.witness(...)  → { ignoreSelectors } (per-snapshot override)
+    let ignoreStyleEl = null;
+    if (isLocalMode) {
+        // Read global ignores from .testivai/config.json
+        let witnessConfigIgnore = [];
+        try {
+            const witnessConfigPath = path.join(process.cwd(), '.testivai', 'config.json');
+            if (fs.existsSync(witnessConfigPath)) {
+                const raw = JSON.parse(fs.readFileSync(witnessConfigPath, 'utf-8'));
+                witnessConfigIgnore = raw.ignoreSelectors ?? [];
+            }
+        }
+        catch { /* ignore malformed config */ }
+        const playwrightConfigIgnore = projectConfig.ignoreSelectors ?? [];
+        const perSnapshotIgnore = effectiveConfig.ignoreSelectors ?? [];
+        const allSelectors = [...new Set([...witnessConfigIgnore, ...playwrightConfigIgnore, ...perSnapshotIgnore])];
+        if (allSelectors.length > 0) {
+            const css = allSelectors.map(s => `${s} { visibility: hidden !important; }`).join('\n');
+            ignoreStyleEl = await page.addStyleTag({ content: css });
+        }
+    }
     // Check if scroll-and-stitch is explicitly requested (backup method)
     if (effectiveConfig.useBrowserCapture === false) {
         // Use scroll-and-stitch approach (backup method)
@@ -310,6 +336,11 @@ async function snapshot(page, testInfo, name, config) {
             await page.screenshot({ path: screenshotPath, fullPage: true });
         }
     }
+    // Restore any elements hidden for ignoreSelectors
+    if (ignoreStyleEl) {
+        await ignoreStyleEl.evaluate((el) => el.remove()).catch(() => { });
+        ignoreStyleEl = null;
+    }
     // 1.5. Local mode: also place the screenshot in the layout expected by
     //      @testivai/witness/report (subdirectory keyed by snapshot name).
     //      This is what `BaselineStore.listTemp()` and `compareAll()` enumerate.

package/dist/types.d.ts

@@ -216,6 +216,18 @@ export interface TestivAIConfig {
     selectors?: string[];
     /** Use browser capture for full-page screenshots (default: true, set to false for scroll-and-stitch) */
     useBrowserCapture?: boolean;
+    /**
+     * CSS selectors for elements to hide during screenshot capture (local mode).
+     * Elements are set to `visibility: hidden` before the screenshot is taken and
+     * restored immediately after — so dynamic content (version badges, timestamps,
+     * ads, live clocks) never contributes to the pixel diff.
+     *
+     * Can also be set globally in `.testivai/config.json` under `ignoreSelectors`.
+     * Per-snapshot values are merged with (not replaced by) the global list.
+     *
+     * Example: ["[data-testivai-ignore]", ".version-badge", "#live-chat-widget"]
+     */
+    ignoreSelectors?: string[];
 }
 /**
  * Layout/Bounding box data for an element

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testivai/witness-playwright",
-  "version": "1.1.5",
+  "version": "1.2.0",
   "description": "Playwright sensor for Testivai Visual Regression Test system",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -52,7 +52,7 @@
     "sharp": "^0.34.5",
     "simple-git": "^3.21.0",
     "@testivai/common": "0.2.2",
-    "@testivai/witness": "1.0.4"
+    "@testivai/witness": "1.1.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",