@letsrunit/playwright 0.7.1 → 0.9.0

package/dist/index.js

@@ -5,6 +5,7 @@ import rehypeStringify from 'rehype-stringify';
 import { unified } from 'unified';
 import stringify from 'fast-json-stable-stringify';
 import { JSDOM } from 'jsdom';
+import * as Diff from 'diff';
 
 // src/browser.ts
 async function browse(browser, options = {}) {
@@ -83,11 +84,11 @@ function formatDateForInput(date, type) {
       return `${yyyy}-${mm}-${dd}`;
   }
 }
-function formatDate(d, format) {
+function formatDate(d, format2) {
   const dd = String(d.getDate()).padStart(2, "0");
   const mm = String(d.getMonth() + 1).padStart(2, "0");
   const yyyy = String(d.getFullYear());
-  return format.replace("DD", dd).replace("MM", mm).replace("YYYY", yyyy);
+  return format2.replace("DD", dd).replace("MM", mm).replace("YYYY", yyyy);
 }
 function getMonthNames(locale) {
   const formatter = new Intl.DateTimeFormat(locale, { month: "long" });
@@ -1226,21 +1227,32 @@ async function formatHtml(page) {
 }
 
 // src/fuzzy-locator.ts
+function debug(...args) {
+  if (process.env.LETSRUNIT_DEBUG_FUZZY_LOCATOR === "1") {
+    console.log("[fuzzyLocator]", ...args);
+  }
+}
 async function fuzzyLocator(page, selector) {
+  debug("input selector:", selector);
   const primary = page.locator(selector);
   const candidates = [
-    tryRelaxNameToHasText(page, selector),
-    tryTagInsteadOfRole(page, selector),
-    tryRoleNameProximity(page, selector),
-    tryFieldAlternative(page, selector),
-    tryAsField(page, selector)
+    { name: "relaxNameToHasText", locator: tryRelaxNameToHasText(page, selector) },
+    { name: "tagInsteadOfRole", locator: tryTagInsteadOfRole(page, selector) },
+    { name: "roleNameProximity", locator: tryRoleNameProximity(page, selector) },
+    { name: "fieldAlternative", locator: tryFieldAlternative(page, selector) },
+    { name: "asField", locator: tryAsField(page, selector) }
   ];
   let combined = primary;
+  const enabled = [];
   for (const candidate of candidates) {
-    if (!candidate) continue;
-    combined = combined.or(candidate);
+    if (!candidate.locator) continue;
+    enabled.push(candidate.name);
+    combined = combined.or(candidate.locator);
   }
-  return combined.first();
+  debug("enabled fallbacks:", enabled.length ? enabled.join(", ") : "(none)");
+  const result = combined.first();
+  debug("returning locator:", result.toString());
+  return result;
 }
 function tryRelaxNameToHasText(page, selector) {
   const matchAnyNameFull = selector.match(/^(role=.*)\[name="([^"]+)"i?](.*)$/i);
@@ -1658,12 +1670,336 @@ async function screenshotWithMask(page, options) {
   }
 }
 
+// src/utils/type-check.ts
+function isPage(page) {
+  return typeof page.content === "function" && typeof page.url === "function" && typeof page.screenshot === "function";
+}
+
+// src/scrub-html.ts
+var HTML_MIN_ATTR_THRESHOLD = 25e4;
+var HTML_LIMIT_LISTS_THRESHOLD = 4e5;
+var HTML_MAIN_ONLY_THRESHOLD = 6e5;
+function getDefaults(contentLength) {
+  return {
+    dropHidden: true,
+    dropHead: true,
+    dropSvg: false,
+    pickMain: contentLength >= HTML_MAIN_ONLY_THRESHOLD,
+    stripAttributes: contentLength >= HTML_MIN_ATTR_THRESHOLD ? 2 : 1,
+    normalizeWhitespace: true,
+    dropComments: true,
+    replaceBrInHeadings: true,
+    limitLists: contentLength >= HTML_LIMIT_LISTS_THRESHOLD ? 20 : -1,
+    dropUtilityClasses: false
+  };
+}
+var ALLOWED_ATTRS = {
+  match: /* @__PURE__ */ new Set([
+    // identity/semantics
+    "id",
+    "class",
+    "role",
+    // internationalization
+    "lang",
+    "dir",
+    // anchors & media
+    "href",
+    "title",
+    "target",
+    "rel",
+    "src",
+    "alt",
+    "width",
+    "height",
+    "loading",
+    // tables
+    "scope",
+    "headers",
+    "colspan",
+    "rowspan",
+    // forms (pure semantics—doesn’t change structure)
+    "name",
+    "value",
+    "type",
+    "for",
+    "placeholder",
+    "checked",
+    "selected",
+    "multiple",
+    "method",
+    "action",
+    // time, figure, etc.
+    "datetime"
+  ]),
+  regexp: /^aria-[\w-]+|^data-[\w-]+$/i
+  // ARIA attributes & data-* attributes
+};
+var ALLOWED_ATTRS_AGGRESSIVE = {
+  match: /* @__PURE__ */ new Set([
+    // structuur / algemene selectors
+    "id",
+    "class",
+    "role",
+    // links / media
+    "href",
+    "src",
+    "alt",
+    "title",
+    // tables
+    "scope",
+    // forms / velden
+    "name",
+    "type",
+    "for",
+    "placeholder",
+    "value",
+    "checked",
+    "selected",
+    // ARIA voor Playwright getByRole/getByLabel
+    "aria-label",
+    "aria-labelledby",
+    "aria-describedby",
+    // veelgebruikte test selectors
+    "data-testid",
+    "data-test-id",
+    "data-cy",
+    "data-qa"
+  ]),
+  regexp: null
+};
+var HIDDEN_SELECTORS = [
+  "[hidden]",
+  "[inert]",
+  '[aria-hidden="true"]',
+  '[style*="display:none"]',
+  '[style*="visibility:hidden"]',
+  '[style*="opacity:0"]'
+].join(",");
+var ALWAYS_DROP = [
+  "script",
+  "style",
+  "template",
+  "noscript",
+  "slot",
+  "object",
+  "embed"
+];
+async function scrubHtml(page, opts = {}) {
+  if (isPage(page)) page = { html: await page.content(), url: page.url() };
+  return await memoizedScrubHtml(page, opts);
+}
+var memoizedScrubHtml = memoize(realScrubHtml, {
+  max: 16,
+  ttl: 10 * 6e4,
+  cacheKey: (args) => stringify({ html: args[0].html, url: args[0].url, ...args[1] })
+});
+async function realScrubHtml({ html, url }, opts = {}) {
+  const o = { ...getDefaults(html.length), ...opts };
+  const dom = new JSDOM(html, { url });
+  const doc = dom.window.document;
+  if (o.pickMain) pickMain(doc);
+  dropInfraAndSvg(doc, !!o.dropSvg);
+  if (o.dropHidden) dropHiddenTrees(doc);
+  if (o.stripAttributes) stripAttributesAndSanitize(doc, o.stripAttributes);
+  if (o.dropComments) dropHtmlComments(doc);
+  if (o.replaceBrInHeadings) replaceBrsInHeadings(doc);
+  if (o.limitLists >= 0) limitListsAndRows(doc, o.limitLists);
+  if (o.dropUtilityClasses) stripUtilityClasses(doc);
+  if (o.normalizeWhitespace) normalizeWhitespace(doc.body);
+  return doc.body.innerHTML;
+}
+function hasHiddenAncestor(el) {
+  let p = el.parentElement;
+  while (p) {
+    if (p.hasAttribute("hidden") || p.hasAttribute("inert") || p.getAttribute("aria-hidden") === "true") return true;
+    const style = p.getAttribute("style") || "";
+    if (/\bdisplay\s*:\s*none\b/i.test(style)) return true;
+    if (/\bvisibility\s*:\s*hidden\b/i.test(style)) return true;
+    if (/\bopacity\s*:\s*0(?:\D|$)/i.test(style)) return true;
+    p = p.parentElement;
+  }
+  return false;
+}
+function normalizeWhitespace(root) {
+  const preLike = /* @__PURE__ */ new Set(["PRE", "CODE", "SAMP", "KBD"]);
+  const doc = root.ownerDocument;
+  const walker = doc.createTreeWalker(
+    root,
+    4
+    /*NodeFilter.SHOW_TEXT*/
+  );
+  const changes = [];
+  let node;
+  while (node = walker.nextNode()) {
+    const text = node;
+    const parent = text.parentElement;
+    if (!parent) continue;
+    if (preLike.has(parent.tagName)) continue;
+    const v = text.nodeValue ?? "";
+    const collapsed = v.replace(/\s+/g, " ");
+    if (collapsed !== v) changes.push(text);
+  }
+  for (const t of changes) {
+    const parent = t.parentElement;
+    const isBlockish = /^(P|LI|DIV|SECTION|ARTICLE|ASIDE|HEADER|FOOTER|MAIN|NAV|H[1-6]|BLOCKQUOTE|FIGCAPTION|TD|TH)$/i.test(parent.tagName);
+    t.nodeValue = (t.nodeValue || "").replace(/\s+/g, " ");
+    if (isBlockish) t.nodeValue = (t.nodeValue || "").trim();
+  }
+}
+function pickMain(doc) {
+  const main = doc.querySelector("main");
+  if (!main) return false;
+  const clone = main.cloneNode(true);
+  doc.body.innerHTML = "";
+  doc.body.appendChild(clone);
+  return true;
+}
+function dropInfraAndSvg(doc, dropSvg) {
+  const toDrop = [...ALWAYS_DROP, dropSvg ? "svg" : ""].filter(Boolean).join(",");
+  if (!toDrop) return;
+  doc.querySelectorAll(toDrop).forEach((el) => el.remove());
+}
+function dropHiddenTrees(doc) {
+  doc.querySelectorAll(HIDDEN_SELECTORS).forEach((el) => el.remove());
+  const all = [...doc.body.querySelectorAll("*")];
+  for (const el of all) {
+    if (!el.isConnected) continue;
+    if (hasHiddenAncestor(el)) el.remove();
+  }
+}
+function stripAttributesAndSanitize(doc, level) {
+  if (!level) return;
+  const all = [...doc.body.querySelectorAll("*")];
+  for (const el of all) {
+    const isSvg = el.namespaceURI === "http://www.w3.org/2000/svg";
+    for (const { name } of [...el.attributes]) {
+      const lower = name.toLowerCase();
+      if (lower.startsWith("on")) {
+        el.removeAttribute(name);
+        continue;
+      }
+      if (lower === "style") {
+        el.removeAttribute(name);
+        continue;
+      }
+      if (isSvg) continue;
+      const allowed = level === 1 ? ALLOWED_ATTRS : ALLOWED_ATTRS_AGGRESSIVE;
+      if (!allowed.match.has(lower) && !allowed.regexp?.test(name)) {
+        el.removeAttribute(name);
+      }
+    }
+  }
+  doc.querySelectorAll("a[href]").forEach((a) => {
+    const href = a.getAttribute("href") || "";
+    if (/^\s*javascript:/i.test(href)) a.removeAttribute("href");
+  });
+}
+function dropHtmlComments(doc) {
+  const nf = doc.defaultView?.NodeFilter;
+  const SHOW_COMMENT = nf?.SHOW_COMMENT ?? 128;
+  const walker = doc.createTreeWalker(doc, SHOW_COMMENT);
+  const toRemove = [];
+  let n;
+  while (n = walker.nextNode()) toRemove.push(n);
+  toRemove.forEach((c) => c.parentNode?.removeChild(c));
+}
+function replaceBrsInHeadings(doc) {
+  doc.querySelectorAll("h1, h2, h3, h4, h5, h6").forEach((h) => {
+    h.querySelectorAll("br").forEach((br) => {
+      const space = doc.createTextNode(" ");
+      br.replaceWith(space);
+    });
+  });
+}
+var UTILITY_VARIANT_RE = /:/;
+var UTILITY_PREFIX_RE = /^-?(?:p[xytblrse]?|m[xytblrse]?|gap|space-[xy]|w|h|min-w|min-h|max-w|max-h|size|basis|inset|top|right|bottom|left|start|end|z|text|bg|border|ring|shadow|outline|fill|stroke|divide|accent|caret|from|via|to|decoration|font|leading|tracking|indent|line-clamp|columns|aspect|object|opacity|rotate|scale|translate|skew|transition|duration|ease|delay|animate|rounded|overflow|overscroll|scroll|snap|touch|cursor|pointer-events|select|resize|flex|grid|col|row|order|auto-cols|auto-rows|items|justify|content|self|place|float|clear|list|whitespace|break|hyphens|mix-blend|bg-blend|backdrop|d|g|fs|fw|lh|align|position)-/i;
+var UTILITY_STANDALONE = /* @__PURE__ */ new Set([
+  "flex",
+  "grid",
+  "block",
+  "hidden",
+  "inline",
+  "inline-block",
+  "inline-flex",
+  "inline-grid",
+  "contents",
+  "flow-root",
+  "list-item",
+  "table",
+  "container",
+  "truncate",
+  "grow",
+  "shrink",
+  "static",
+  "relative",
+  "absolute",
+  "fixed",
+  "sticky",
+  "visible",
+  "invisible",
+  "collapse",
+  "isolate",
+  "underline",
+  "overline",
+  "line-through",
+  "no-underline",
+  "uppercase",
+  "lowercase",
+  "capitalize",
+  "normal-case",
+  "italic",
+  "not-italic",
+  "antialiased",
+  "subpixel-antialiased",
+  "sr-only",
+  "not-sr-only",
+  "clearfix",
+  "row",
+  "col"
+]);
+function isUtilityClass(token) {
+  if (UTILITY_VARIANT_RE.test(token)) return true;
+  const base = token.startsWith("-") ? token.slice(1) : token;
+  if (UTILITY_STANDALONE.has(base)) return true;
+  return UTILITY_PREFIX_RE.test(token);
+}
+function stripUtilityClasses(doc) {
+  for (const el of doc.body.querySelectorAll("[class]")) {
+    const kept = el.className.split(/\s+/).filter((t) => t && !isUtilityClass(t));
+    if (kept.length === 0) el.removeAttribute("class");
+    else el.className = kept.join(" ");
+  }
+}
+function limitListsAndRows(doc, limit) {
+  doc.querySelectorAll("ul, ol").forEach((list) => {
+    const items = Array.from(list.children).filter((c) => c.tagName === "LI");
+    for (let i = limit; i < items.length; i++) items[i].remove();
+  });
+  const rowContainers = doc.querySelectorAll("table, thead, tbody, tfoot");
+  rowContainers.forEach((container) => {
+    const rows = Array.from(container.children).filter((c) => c.tagName === "TR");
+    for (let i = limit; i < rows.length; i++) rows[i].remove();
+  });
+}
+
 // src/snapshot.ts
-async function snapshot(page) {
+async function snapshot(page, opts = {}) {
   await sleep(500);
   await waitForDomIdle(page);
   const [url, html, file] = await Promise.all([page.url(), getContentWithMarkedHidden(page), screenshot(page)]);
-  return { url, html, screenshot: file };
+  const finalHtml = opts.dropUtilityClasses ? await realScrubHtml({ html, url }, {
+    dropHidden: false,
+    dropHead: false,
+    dropSvg: false,
+    pickMain: false,
+    stripAttributes: 0,
+    normalizeWhitespace: false,
+    dropComments: false,
+    replaceBrInHeadings: false,
+    limitLists: -1,
+    dropUtilityClasses: true
+  }) : html;
+  return { url, html: finalHtml, screenshot: file };
 }
 async function getContentWithMarkedHidden(page) {
   try {
@@ -3190,258 +3526,17 @@ async function suppressInterferences(page, opts = {}) {
     await sleep(pollIntervalMs);
   }
 }
-
-// src/utils/type-check.ts
-function isPage(page) {
-  return typeof page.content === "function" && typeof page.url === "function" && typeof page.screenshot === "function";
-}
-
-// src/scrub-html.ts
-var HTML_MIN_ATTR_THRESHOLD = 25e4;
-var HTML_LIMIT_LISTS_THRESHOLD = 4e5;
-var HTML_MAIN_ONLY_THRESHOLD = 6e5;
-function getDefaults(contentLength) {
-  return {
-    dropHidden: true,
-    dropHead: true,
-    dropSvg: false,
-    pickMain: contentLength >= HTML_MAIN_ONLY_THRESHOLD,
-    stripAttributes: contentLength >= HTML_MIN_ATTR_THRESHOLD ? 2 : 1,
-    normalizeWhitespace: true,
-    dropComments: true,
-    replaceBrInHeadings: true,
-    limitLists: contentLength >= HTML_LIMIT_LISTS_THRESHOLD ? 20 : -1
-  };
-}
-var ALLOWED_ATTRS = {
-  match: /* @__PURE__ */ new Set([
-    // identity/semantics
-    "id",
-    "class",
-    "role",
-    // internationalization
-    "lang",
-    "dir",
-    // anchors & media
-    "href",
-    "title",
-    "target",
-    "rel",
-    "src",
-    "alt",
-    "width",
-    "height",
-    "loading",
-    // tables
-    "scope",
-    "headers",
-    "colspan",
-    "rowspan",
-    // forms (pure semantics—doesn’t change structure)
-    "name",
-    "value",
-    "type",
-    "for",
-    "placeholder",
-    "checked",
-    "selected",
-    "multiple",
-    "method",
-    "action",
-    // time, figure, etc.
-    "datetime"
-  ]),
-  regexp: /^aria-[\w-]+|^data-[\w-]+$/i
-  // ARIA attributes & data-* attributes
-};
-var ALLOWED_ATTRS_AGGRESSIVE = {
-  match: /* @__PURE__ */ new Set([
-    // structuur / algemene selectors
-    "id",
-    "class",
-    "role",
-    // links / media
-    "href",
-    "src",
-    "alt",
-    "title",
-    // tables
-    "scope",
-    // forms / velden
-    "name",
-    "type",
-    "for",
-    "placeholder",
-    "value",
-    "checked",
-    "selected",
-    // ARIA voor Playwright getByRole/getByLabel
-    "aria-label",
-    "aria-labelledby",
-    "aria-describedby",
-    // veelgebruikte test selectors
-    "data-testid",
-    "data-test-id",
-    "data-cy",
-    "data-qa"
-  ]),
-  regexp: null
-};
-var HIDDEN_SELECTORS = [
-  "[hidden]",
-  "[inert]",
-  '[aria-hidden="true"]',
-  '[style*="display:none"]',
-  '[style*="visibility:hidden"]',
-  '[style*="opacity:0"]'
-].join(",");
-var ALWAYS_DROP = [
-  "script",
-  "style",
-  "template",
-  "noscript",
-  "slot",
-  "object",
-  "embed"
-];
-async function scrubHtml(page, opts = {}) {
-  if (isPage(page)) page = { html: await page.content(), url: page.url() };
-  return await memoizedScrubHtml(page, opts);
-}
-var memoizedScrubHtml = memoize(realScrubHtml, {
-  max: 16,
-  ttl: 10 * 6e4,
-  cacheKey: (args) => stringify({ html: args[0].html, url: args[0].url, ...args[1] })
-});
-async function realScrubHtml({ html, url }, opts = {}) {
-  const o = { ...getDefaults(html.length), ...opts };
-  const dom = new JSDOM(html, { url });
-  const doc = dom.window.document;
-  if (o.pickMain) pickMain(doc);
-  dropInfraAndSvg(doc, !!o.dropSvg);
-  if (o.dropHidden) dropHiddenTrees(doc);
-  if (o.stripAttributes) stripAttributesAndSanitize(doc, o.stripAttributes);
-  if (o.dropComments) dropHtmlComments(doc);
-  if (o.replaceBrInHeadings) replaceBrsInHeadings(doc);
-  if (o.limitLists >= 0) limitListsAndRows(doc, o.limitLists);
-  if (o.normalizeWhitespace) normalizeWhitespace(doc.body);
-  return doc.body.innerHTML;
-}
-function hasHiddenAncestor(el) {
-  let p = el.parentElement;
-  while (p) {
-    if (p.hasAttribute("hidden") || p.hasAttribute("inert") || p.getAttribute("aria-hidden") === "true") return true;
-    const style = p.getAttribute("style") || "";
-    if (/\bdisplay\s*:\s*none\b/i.test(style)) return true;
-    if (/\bvisibility\s*:\s*hidden\b/i.test(style)) return true;
-    if (/\bopacity\s*:\s*0(?:\D|$)/i.test(style)) return true;
-    p = p.parentElement;
-  }
-  return false;
-}
-function normalizeWhitespace(root) {
-  const preLike = /* @__PURE__ */ new Set(["PRE", "CODE", "SAMP", "KBD"]);
-  const doc = root.ownerDocument;
-  const walker = doc.createTreeWalker(
-    root,
-    4
-    /*NodeFilter.SHOW_TEXT*/
-  );
-  const changes = [];
-  let node;
-  while (node = walker.nextNode()) {
-    const text = node;
-    const parent = text.parentElement;
-    if (!parent) continue;
-    if (preLike.has(parent.tagName)) continue;
-    const v = text.nodeValue ?? "";
-    const collapsed = v.replace(/\s+/g, " ");
-    if (collapsed !== v) changes.push(text);
-  }
-  for (const t of changes) {
-    const parent = t.parentElement;
-    const isBlockish = /^(P|LI|DIV|SECTION|ARTICLE|ASIDE|HEADER|FOOTER|MAIN|NAV|H[1-6]|BLOCKQUOTE|FIGCAPTION|TD|TH)$/i.test(parent.tagName);
-    t.nodeValue = (t.nodeValue || "").replace(/\s+/g, " ");
-    if (isBlockish) t.nodeValue = (t.nodeValue || "").trim();
-  }
-}
-function pickMain(doc) {
-  const main = doc.querySelector("main");
-  if (!main) return false;
-  const clone = main.cloneNode(true);
-  doc.body.innerHTML = "";
-  doc.body.appendChild(clone);
-  return true;
-}
-function dropInfraAndSvg(doc, dropSvg) {
-  const toDrop = [...ALWAYS_DROP, dropSvg ? "svg" : ""].filter(Boolean).join(",");
-  if (!toDrop) return;
-  doc.querySelectorAll(toDrop).forEach((el) => el.remove());
-}
-function dropHiddenTrees(doc) {
-  doc.querySelectorAll(HIDDEN_SELECTORS).forEach((el) => el.remove());
-  const all = [...doc.body.querySelectorAll("*")];
-  for (const el of all) {
-    if (!el.isConnected) continue;
-    if (hasHiddenAncestor(el)) el.remove();
-  }
-}
-function stripAttributesAndSanitize(doc, level) {
-  if (!level) return;
-  const all = [...doc.body.querySelectorAll("*")];
-  for (const el of all) {
-    const isSvg = el.namespaceURI === "http://www.w3.org/2000/svg";
-    for (const { name } of [...el.attributes]) {
-      const lower = name.toLowerCase();
-      if (lower.startsWith("on")) {
-        el.removeAttribute(name);
-        continue;
-      }
-      if (lower === "style") {
-        el.removeAttribute(name);
-        continue;
-      }
-      if (isSvg) continue;
-      const allowed = level === 1 ? ALLOWED_ATTRS : ALLOWED_ATTRS_AGGRESSIVE;
-      if (!allowed.match.has(lower) && !allowed.regexp?.test(name)) {
-        el.removeAttribute(name);
-      }
-    }
-  }
-  doc.querySelectorAll("a[href]").forEach((a) => {
-    const href = a.getAttribute("href") || "";
-    if (/^\s*javascript:/i.test(href)) a.removeAttribute("href");
-  });
-}
-function dropHtmlComments(doc) {
-  const nf = doc.defaultView?.NodeFilter;
-  const SHOW_COMMENT = nf?.SHOW_COMMENT ?? 128;
-  const walker = doc.createTreeWalker(doc, SHOW_COMMENT);
-  const toRemove = [];
-  let n;
-  while (n = walker.nextNode()) toRemove.push(n);
-  toRemove.forEach((c) => c.parentNode?.removeChild(c));
+async function format(rawHtml, url) {
+  const html = await scrubHtml({ html: rawHtml, url });
+  return await formatHtml(html);
 }
-function replaceBrsInHeadings(doc) {
-  doc.querySelectorAll("h1, h2, h3, h4, h5, h6").forEach((h) => {
-    h.querySelectorAll("br").forEach((br) => {
-      const space = doc.createTextNode(" ");
-      br.replaceWith(space);
-    });
-  });
-}
-function limitListsAndRows(doc, limit) {
-  doc.querySelectorAll("ul, ol").forEach((list) => {
-    const items = Array.from(list.children).filter((c) => c.tagName === "LI");
-    for (let i = limit; i < items.length; i++) items[i].remove();
-  });
-  const rowContainers = doc.querySelectorAll("table, thead, tbody, tfoot");
-  rowContainers.forEach((container) => {
-    const rows = Array.from(container.children).filter((c) => c.tagName === "TR");
-    for (let i = limit; i < rows.length; i++) rows[i].remove();
-  });
+async function unifiedHtmlDiff(old, current) {
+  if (isPage(old)) old = { html: await old.content(), url: old.url() };
+  if (isPage(current)) current = { html: await current.content(), url: current.url() };
+  const [a, b] = await Promise.all([format(old.html, old.url), format(current.html, current.url)]);
+  return Diff.createTwoFilesPatch("before.html", "after.html", a, b);
 }
 
-export { browse, createDateEngine, createFieldEngine, formatDate, formatDateForInput, formatHtml, fuzzyLocator, getMonthNames, realScrubHtml, screenshot, screenshotElement, scrollToCenter, scrubHtml, setFieldValue, snapshot, suppressInterferences, waitAfterInteraction, waitForAnimationsToFinish, waitForDomIdle, waitForIdle, waitForMeta, waitForUrlChange, waitUntilEnabled };
+export { browse, createDateEngine, createFieldEngine, formatDate, formatDateForInput, formatHtml, fuzzyLocator, getMonthNames, realScrubHtml, screenshot, screenshotElement, scrollToCenter, scrubHtml, setFieldValue, snapshot, suppressInterferences, unifiedHtmlDiff, waitAfterInteraction, waitForAnimationsToFinish, waitForDomIdle, waitForIdle, waitForMeta, waitForUrlChange, waitUntilEnabled };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map