@letsrunit/playwright 0.7.1 → 0.8.0

package/dist/index.d.ts

@@ -63,7 +63,11 @@ interface PageInfo {
     screenshot?: File;
 }
 
-declare function snapshot(page: Page): Promise<Snapshot>;
+type SnapshotOptions = {
+    /** Strip utility-framework classes (Tailwind, Bootstrap, UnoCSS, Windi) from the captured HTML. */
+    dropUtilityClasses?: boolean;
+};
+declare function snapshot(page: Page, opts?: SnapshotOptions): Promise<Snapshot>;
 
 declare function screenshotElement(page: Page, selector: string, options?: LocatorScreenshotOptions): Promise<File>;
 declare function screenshot(page: Page, options?: PageScreenshotOptions): Promise<File>;
@@ -123,6 +127,9 @@ type ScrubHtmlOptions = {
     replaceBrInHeadings?: boolean;
     /** Limit lists to max items: -1 mean no limit. Default: -1 */
     limitLists?: number;
+    /** Strip utility-framework classes (Tailwind, Bootstrap, UnoCSS, Windi) from class
+     *  attributes. Removes the attribute entirely when all classes are stripped. Default: false */
+    dropUtilityClasses?: boolean;
 };
 declare function scrubHtml(page: {
     html: string;
@@ -136,4 +143,12 @@ declare function realScrubHtml({ html, url }: {
     url: string;
 }, opts?: ScrubHtmlOptions): Promise<string>;
 
-export { type PageInfo, type ScrubHtmlOptions, type Snapshot, browse, createDateEngine, createFieldEngine, formatDate, formatDateForInput, formatHtml, fuzzyLocator, getMonthNames, realScrubHtml, screenshot, screenshotElement, scrollToCenter, scrubHtml, setFieldValue, snapshot, suppressInterferences, waitAfterInteraction, waitForAnimationsToFinish, waitForDomIdle, waitForIdle, waitForMeta, waitForUrlChange, waitUntilEnabled };
+declare function unifiedHtmlDiff(old: {
+    html: string;
+    url: string;
+} | Page, current: {
+    html: string;
+    url: string;
+} | Page): Promise<string>;
+
+export { type PageInfo, type ScrubHtmlOptions, type Snapshot, type SnapshotOptions, browse, createDateEngine, createFieldEngine, formatDate, formatDateForInput, formatHtml, fuzzyLocator, getMonthNames, realScrubHtml, screenshot, screenshotElement, scrollToCenter, scrubHtml, setFieldValue, snapshot, suppressInterferences, unifiedHtmlDiff, waitAfterInteraction, waitForAnimationsToFinish, waitForDomIdle, waitForIdle, waitForMeta, waitForUrlChange, waitUntilEnabled };

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" });
@@ -1658,12 +1659,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 +3515,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());
+async function format(rawHtml, url) {
+  const html = await scrubHtml({ html: rawHtml, url });
+  return await formatHtml(html);
 }
-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);
-    });
-  });
-}
-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