@letsrunit/playwright 0.6.0 → 0.7.1

package/dist/index.d.ts

@@ -15,7 +15,7 @@ declare function setFieldValue(el: Locator, value: Value, options?: SetOptions):
 declare function formatHtml(page: string | Page): Promise<string>;
 
 /**
- * Locates an element using Playwright selectors, with fallbacks.
+ * Locates an element using Playwright selectors, with lazy fallbacks.
  */
 declare function fuzzyLocator(page: Page, selector: string): Promise<Locator>;
 

package/dist/index.js

@@ -14,9 +14,12 @@ async function browse(browser, options = {}) {
     locale: "en-US",
     ...options
   });
-  await context.addInitScript(() => {
-    window.__name = window.__name || ((fn) => fn);
-  });
+  await context.addInitScript(
+    /* v8 ignore next */
+    () => {
+      window.__name = window.__name || ((fn) => fn);
+    }
+  );
   return await context.newPage();
 }
 
@@ -101,6 +104,7 @@ async function waitForMeta(page, timeout = 2500) {
   await waitForIdle(page);
   page.getByRole("navigation");
   await page.waitForFunction(
+    /* v8 ignore start */
     () => {
       const head = document.head;
       if (!head) return false;
@@ -108,12 +112,14 @@ async function waitForMeta(page, timeout = 2500) {
         document.title.trim() || head.querySelector('meta[property^="og:"]') || head.querySelector('meta[name^="twitter:"]') || head.querySelector('script[type="application/ld+json"]')
       );
     },
+    /* v8 ignore stop */
     { timeout }
   ).catch(() => {
   });
 }
 async function waitForDomIdle(page, { quiet = 500, timeout = 1e4 } = {}) {
   await page.waitForFunction(
+    /* v8 ignore start */
     (q) => new Promise((resolve) => {
       let last = performance.now();
       const obs = new MutationObserver(() => last = performance.now());
@@ -133,23 +139,31 @@ async function waitForDomIdle(page, { quiet = 500, timeout = 1e4 } = {}) {
       };
       tick();
     }),
+    /* v8 ignore stop */
     quiet,
     { timeout }
   );
 }
 async function waitForAnimationsToFinish(root) {
   await root.page().waitForFunction(
+    /* v8 ignore start */
     (el) => {
       const animations = el.getAnimations?.({ subtree: true }) ?? [];
       return animations.every((a) => a.playState !== "running");
     },
+    /* v8 ignore stop */
     await root.elementHandle()
   );
   await root.evaluate(() => new Promise((r) => requestAnimationFrame(() => requestAnimationFrame(() => r()))));
 }
 async function waitForUrlChange(page, prevUrl, timeout) {
   try {
-    await page.waitForFunction((u) => location.href !== u, prevUrl, { timeout });
+    await page.waitForFunction(
+      /* v8 ignore next */
+      (u) => location.href !== u,
+      prevUrl,
+      { timeout }
+    );
     return true;
   } catch {
     return false;
@@ -161,12 +175,14 @@ async function waitUntilEnabled(page, target, timeout) {
   const handle = await target.elementHandle().catch(() => null);
   if (!handle) return;
   await page.waitForFunction(
+    /* v8 ignore start */
     (el) => {
       if (!el || !el.isConnected) return true;
       const aria = el.getAttribute("aria-disabled");
       const disabled = el.disabled || aria === "true" || el.getAttribute("disabled") !== null;
       return !disabled;
     },
+    /* v8 ignore stop */
     handle,
     { timeout }
   ).catch(() => {
@@ -213,7 +229,12 @@ async function elementKind(target) {
   const role = await target.getAttribute("role", { timeout: PROBE }).catch(() => null);
   if (role === "link") return "link";
   if (role === "button") return "button";
-  const tag = await target.evaluate((el) => el.tagName.toLowerCase(), null, { timeout: PROBE }).catch(() => "");
+  const tag = await target.evaluate(
+    /* v8 ignore next */
+    (el) => el.tagName.toLowerCase(),
+    null,
+    { timeout: PROBE }
+  ).catch(() => "");
   if (tag === "a") return "link";
   if (tag === "button") return "button";
   if (tag === "input") {
@@ -255,9 +276,7 @@ async function getCalendar(root, options) {
   if (!container) return null;
   const found = await container.locator(gridSelector).all();
   const tables = [];
-  if (await isCalendarGrid(container)) {
-    tables.push(container);
-  }
+  if (await isCalendarGrid(container)) tables.push(container);
   for (const grid of found) {
     if (await isCalendarGrid(grid)) {
       tables.push(grid);
@@ -467,33 +486,37 @@ async function getCandidateLocs(el, options) {
   if (candidates.length < 2 || candidates.length > 3) return [];
   return Promise.all(
     candidates.map(async (c) => {
-      const info = await c.evaluate((node) => {
-        const e = node;
-        const attrs = {};
-        for (const attr of e.attributes) {
-          attrs[attr.name] = attr.value;
-        }
-        let options2 = [];
-        if (e.tagName.toLowerCase() === "select") {
-          options2 = Array.from(e.options).map((o) => ({
-            value: o.value,
-            text: o.text
-          }));
-        }
-        return {
-          tag: e.tagName.toLowerCase(),
-          type: e.getAttribute("type"),
-          name: e.getAttribute("name"),
-          id: e.getAttribute("id"),
-          ariaLabel: e.getAttribute("aria-label"),
-          placeholder: e.getAttribute("placeholder"),
-          min: e.getAttribute("min"),
-          max: e.getAttribute("max"),
-          inputMode: e.getAttribute("inputmode"),
-          attrs,
-          options: options2
-        };
-      }, options);
+      const info = await c.evaluate(
+        /* v8 ignore start */
+        (node) => {
+          const e = node;
+          const attrs = {};
+          for (const attr of e.attributes) {
+            attrs[attr.name] = attr.value;
+          }
+          let options2 = [];
+          if (e.tagName.toLowerCase() === "select") {
+            options2 = Array.from(e.options).map((o) => ({
+              value: o.value,
+              text: o.text
+            }));
+          }
+          return {
+            tag: e.tagName.toLowerCase(),
+            type: e.getAttribute("type"),
+            name: e.getAttribute("name"),
+            id: e.getAttribute("id"),
+            ariaLabel: e.getAttribute("aria-label"),
+            placeholder: e.getAttribute("placeholder"),
+            min: e.getAttribute("min"),
+            max: e.getAttribute("max"),
+            inputMode: e.getAttribute("inputmode"),
+            attrs,
+            options: options2
+          };
+        },
+        options
+      );
       return { el: c, ...info };
     })
   );
@@ -529,50 +552,70 @@ async function behavioralProbe(candidateLocs, scores, options) {
     for (let i = 0; i < candidateLocs.length; i++) {
       const loc = candidateLocs[i];
       if (loc.tag === "input") {
-        const can_be_day = await loc.el.evaluate((node) => {
-          const e = node;
-          const old = e.value;
-          e.value = "31";
-          const valid = e.checkValidity();
-          e.value = old;
-          return valid;
-        }, options);
+        const can_be_day = await loc.el.evaluate(
+          /* v8 ignore start */
+          (node) => {
+            const e = node;
+            const old = e.value;
+            e.value = "31";
+            const valid = e.checkValidity();
+            e.value = old;
+            return valid;
+          },
+          options
+        );
         if (can_be_day) scores[i].day += 1;
-        const cannot_be_day = await loc.el.evaluate((node) => {
-          const e = node;
-          const old = e.value;
-          e.value = "32";
-          const valid = !e.checkValidity();
-          e.value = old;
-          return valid;
-        }, options);
+        const cannot_be_day = await loc.el.evaluate(
+          /* v8 ignore start */
+          (node) => {
+            const e = node;
+            const old = e.value;
+            e.value = "32";
+            const valid = !e.checkValidity();
+            e.value = old;
+            return valid;
+          },
+          options
+        );
         if (cannot_be_day) scores[i].day += 1;
-        const can_be_month = await loc.el.evaluate((node) => {
-          const e = node;
-          const old = e.value;
-          e.value = "12";
-          const valid = e.checkValidity();
-          e.value = old;
-          return valid;
-        }, options);
+        const can_be_month = await loc.el.evaluate(
+          /* v8 ignore start */
+          (node) => {
+            const e = node;
+            const old = e.value;
+            e.value = "12";
+            const valid = e.checkValidity();
+            e.value = old;
+            return valid;
+          },
+          options
+        );
         if (can_be_month) scores[i].month += 1;
-        const cannot_be_month = await loc.el.evaluate((node) => {
-          const e = node;
-          const old = e.value;
-          e.value = "13";
-          const valid = !e.checkValidity();
-          e.value = old;
-          return valid;
-        }, options);
+        const cannot_be_month = await loc.el.evaluate(
+          /* v8 ignore start */
+          (node) => {
+            const e = node;
+            const old = e.value;
+            e.value = "13";
+            const valid = !e.checkValidity();
+            e.value = old;
+            return valid;
+          },
+          options
+        );
         if (cannot_be_month) scores[i].month += 1;
-        const can_be_year = await loc.el.evaluate((node) => {
-          const e = node;
-          const old = e.value;
-          e.value = "2024";
-          const valid = e.checkValidity();
-          e.value = old;
-          return valid;
-        }, options);
+        const can_be_year = await loc.el.evaluate(
+          /* v8 ignore start */
+          (node) => {
+            const e = node;
+            const old = e.value;
+            e.value = "2024";
+            const valid = e.checkValidity();
+            e.value = old;
+            return valid;
+          },
+          options
+        );
         if (can_be_year) scores[i].year += 1;
       }
     }
@@ -688,22 +731,26 @@ function parseDateString(value, order, sep) {
   return dt;
 }
 async function inferLocaleAndPattern(el, options) {
-  return el.evaluate(() => {
-    const lang = document.documentElement.getAttribute("lang") || navigator.language || "en-US";
-    const dtf = new Intl.DateTimeFormat(lang, { year: "numeric", month: "2-digit", day: "2-digit" });
-    const parts = dtf.formatToParts(new Date(2033, 10, 22));
-    const order = [];
-    let sep = "/";
-    for (const p of parts) {
-      if (p.type === "day" || p.type === "month" || p.type === "year") order.push(p.type);
-      if (p.type === "literal") {
-        const lit = p.value.trim();
-        if (lit) sep = lit;
+  return el.evaluate(
+    /* v8 ignore start */
+    () => {
+      const lang = document.documentElement.getAttribute("lang") || navigator.language || "en-US";
+      const dtf = new Intl.DateTimeFormat(lang, { year: "numeric", month: "2-digit", day: "2-digit" });
+      const parts = dtf.formatToParts(new Date(2033, 10, 22));
+      const order = [];
+      let sep = "/";
+      for (const p of parts) {
+        if (p.type === "day" || p.type === "month" || p.type === "year") order.push(p.type);
+        if (p.type === "literal") {
+          const lit = p.value.trim();
+          if (lit) sep = lit;
+        }
       }
-    }
-    const finalOrder = order.length === 3 ? order : ["day", "month", "year"];
-    return { locale: lang, order: finalOrder, sep };
-  }, options);
+      const finalOrder = order.length === 3 ? order : ["day", "month", "year"];
+      return { locale: lang, order: finalOrder, sep };
+    },
+    options
+  );
 }
 async function fillAndReadBack(el, s, options, nextInput) {
   await el.clear(options);
@@ -711,9 +758,16 @@ async function fillAndReadBack(el, s, options, nextInput) {
   if (nextInput) {
     await nextInput.focus(options);
   } else {
-    await el.evaluate((el2) => el2.blur(), options);
+    await el.evaluate(
+      /* v8 ignore next */
+      (el2) => el2.blur(),
+      options
+    );
   }
-  await el.evaluate(() => new Promise(requestAnimationFrame));
+  await el.evaluate(
+    /* v8 ignore next */
+    () => new Promise(requestAnimationFrame)
+  );
   return await el.inputValue(options);
 }
 function isAmbiguous(value, value2) {
@@ -853,10 +907,13 @@ async function setSingleDate({ el, tag, type }, value, options) {
       "input[type=date], input[type=datetime-local], input[type=month], input[type=week], input[type=time]"
     );
     if (await inputs.count() === 1) {
-      const isVisible = await inputs.evaluate((e) => {
-        const style = window.getComputedStyle(e);
-        return style.display !== "none" && style.visibility !== "hidden" && e.getAttribute("type") !== "hidden";
-      });
+      const isVisible = await inputs.evaluate(
+        /* v8 ignore next */
+        (e) => {
+          const style = window.getComputedStyle(e);
+          return style.display !== "none" && style.visibility !== "hidden" && e.getAttribute("type") !== "hidden";
+        }
+      );
       if (isVisible) {
         target = inputs;
         targetType = await target.getAttribute("type", options) || null;
@@ -909,11 +966,20 @@ async function setNativeInput({ el, tag }, value, options) {
 // src/field/aria-select.ts
 async function selectAria({ el }, value, options) {
   if (typeof value !== "string" && typeof value !== "number") return false;
-  const role = await el.getAttribute("role", options).catch(() => null);
+  const role = await el.getAttribute("role", options).catch(
+    /* v8 ignore next */
+    () => null
+  );
   if (role !== "combobox") return false;
-  const ariaControls = await el.getAttribute("aria-controls", options).catch(() => null);
+  const ariaControls = await el.getAttribute("aria-controls", options).catch(
+    /* v8 ignore next */
+    () => null
+  );
   if (!ariaControls) return false;
-  const ariaExpanded = await el.getAttribute("aria-expanded", options).catch(() => null);
+  const ariaExpanded = await el.getAttribute("aria-expanded", options).catch(
+    /* v8 ignore next */
+    () => null
+  );
   if (ariaExpanded !== "true") await el.click(options);
   const stringValue = String(value);
   const listbox = el.page().locator(`#${ariaControls}`);
@@ -962,14 +1028,20 @@ async function setRadioGroup({ el }, value, options) {
   const ariaRadio = el.locator(`[role="radio"][value="${stringValue}"]`);
   if (await ariaRadio.count() >= 1) {
     const item = ariaRadio.first();
-    const ariaChecked = await item.getAttribute("aria-checked", options).catch(() => null);
+    const ariaChecked = await item.getAttribute("aria-checked", options).catch(
+      /* v8 ignore next */
+      () => null
+    );
     if (ariaChecked !== "true") await item.click(options);
     return true;
   }
   const ariaRadioByLabel = el.getByLabel(stringValue, { exact: true }).locator('[role="radio"]');
   if (await ariaRadioByLabel.count() >= 1) {
     const item = ariaRadioByLabel.first();
-    const ariaChecked = await item.getAttribute("aria-checked", options).catch(() => null);
+    const ariaChecked = await item.getAttribute("aria-checked", options).catch(
+      /* v8 ignore next */
+      () => null
+    );
     if (ariaChecked !== "true") await item.click(options);
     return true;
   }
@@ -1093,9 +1165,15 @@ async function setSliderByKeyboard(slider, initialValue, targetValue, options) {
 // src/field/toggle.ts
 async function setToggle({ el }, value, options) {
   if (typeof value !== "boolean" && value !== null) return false;
-  const role = await el.getAttribute("role", options).catch(() => null);
+  const role = await el.getAttribute("role", options).catch(
+    /* v8 ignore next */
+    () => null
+  );
   if (role !== "checkbox" && role !== "switch") return false;
-  const ariaChecked = await el.getAttribute("aria-checked", options).catch(() => null);
+  const ariaChecked = await el.getAttribute("aria-checked", options).catch(
+    /* v8 ignore next */
+    () => null
+  );
   const isChecked = ariaChecked === "true";
   if (Boolean(value) !== isChecked) await el.click(options);
   return true;
@@ -1134,7 +1212,10 @@ async function setFieldValue(el, value, options) {
     el = await pickFieldElement(el);
   }
   const tag = await el.evaluate((e) => e.tagName.toLowerCase(), options);
-  const type = await el.getAttribute("type", options).then((s) => s && s.toLowerCase()).catch(() => null);
+  const type = await el.getAttribute("type", options).then((s) => s && s.toLowerCase()).catch(
+    /* v8 ignore next */
+    () => null
+  );
   const loc = { el, tag, type };
   await setValue(loc, value, options);
 }
@@ -1146,47 +1227,51 @@ async function formatHtml(page) {
 
 // src/fuzzy-locator.ts
 async function fuzzyLocator(page, selector) {
-  const primary = page.locator(selector).first();
-  if (await primary.count()) return primary;
-  return await tryRelaxNameToHasText(page, selector) || await tryTagInsteadOfRole(page, selector) || await tryRoleNameProximity(page, selector) || await tryFieldAlternative(page, selector) || await tryAsField(page, selector) || primary;
-}
-async function firstMatch(page, sel, opts = {}) {
-  for (const selector of Array.isArray(sel) ? sel : [sel]) {
-    const loc = page.locator(selector, opts).first();
-    if (await loc.count()) return loc;
+  const primary = page.locator(selector);
+  const candidates = [
+    tryRelaxNameToHasText(page, selector),
+    tryTagInsteadOfRole(page, selector),
+    tryRoleNameProximity(page, selector),
+    tryFieldAlternative(page, selector),
+    tryAsField(page, selector)
+  ];
+  let combined = primary;
+  for (const candidate of candidates) {
+    if (!candidate) continue;
+    combined = combined.or(candidate);
   }
-  return null;
+  return combined.first();
 }
-async function tryRelaxNameToHasText(page, selector) {
+function tryRelaxNameToHasText(page, selector) {
   const matchAnyNameFull = selector.match(/^(role=.*)\[name="([^"]+)"i?](.*)$/i);
   if (!matchAnyNameFull) return null;
   const [, pre, nameText, post] = matchAnyNameFull;
   const containsSelector = `${pre}${post}`;
-  return firstMatch(page, containsSelector, { hasText: nameText });
+  return page.locator(containsSelector, { hasText: nameText });
 }
-async function tryTagInsteadOfRole(page, selector) {
+function tryTagInsteadOfRole(page, selector) {
   const matchAnyNameFull = selector.match(/^role=(link|button|option)\s*\[name="([^"]+)"i?](.*)$/i);
   if (!matchAnyNameFull) return null;
   const [, role, nameText, post] = matchAnyNameFull;
   const tag = role === "link" ? "a" : role;
   const containsSelector = `css=${tag}${post}`;
-  return firstMatch(page, containsSelector, { hasText: nameText });
+  return page.locator(containsSelector, { hasText: nameText });
 }
-async function tryRoleNameProximity(page, selector) {
+function tryRoleNameProximity(page, selector) {
   const matchRole = selector.match(/^role=(\w+)\s*\[name="([^"]+)"i?](.*)$/i);
   if (!matchRole) return null;
   const [, role, name, rest] = matchRole;
   const proximitySelector = `text=${name} >> .. >> role=${role}${rest}`;
-  return firstMatch(page, proximitySelector);
+  return page.locator(proximitySelector);
 }
-async function tryFieldAlternative(page, selector) {
+function tryFieldAlternative(page, selector) {
   const matchField = selector.match(/^field="([^"]+)"i?$/i);
   if (!matchField) return null;
   const [, field] = matchField;
   if (!/^[a-zA-Z0-9_-]+$/.test(field)) return null;
-  return firstMatch(page, `#${field} > input`);
+  return page.locator(`#${field} > input`);
 }
-async function tryAsField(page, selector) {
+function tryAsField(page, selector) {
   const matchRole = selector.match(/^role=(\w+)\s*\[name="([^"]+)"i?](.*)$/i);
   if (!matchRole) return null;
   const [, role, name, rest] = matchRole;
@@ -1206,7 +1291,7 @@ async function tryAsField(page, selector) {
     "option"
   ]);
   if (!fieldRoles.has(role.toLowerCase())) return null;
-  return firstMatch(page, `field=${name}${rest}`);
+  return page.locator(`field=${name}${rest}`);
 }
 
 // src/selector/date-selector.ts
@@ -2934,8 +3019,12 @@ async function tryClick(page, selectors, _label) {
   return false;
 }
 async function closeNativeJsAlerts(page) {
-  page.on("dialog", (d) => d.accept().catch(() => {
-  }));
+  page.on(
+    "dialog",
+    /* v8 ignore next */
+    (d) => d.accept().catch(() => {
+    })
+  );
 }
 async function sweepKnownCMPs(page, preferReject) {
   for (const cmp of knownCMPSelectors) {
@@ -3014,6 +3103,7 @@ async function sweepOverlays(page, regex) {
   const acceptRxSource = regex.accept.source;
   const acceptRxFlags = regex.accept.flags;
   return await page.evaluate(
+    /* v8 ignore start */
     ([source, flags]) => {
       const acceptRx = new RegExp(source, flags);
       const isBig = (el) => {
@@ -3029,7 +3119,7 @@ async function sweepOverlays(page, regex) {
       }).slice(0, 5);
       for (const el of candidates) {
         const btn = el.querySelector(
-          '[aria-label*="close" i], button[aria-label*="close" i], button:has(svg), .close, [data-close], .btn-close'
+          "[aria-label*=\u201Dclose\u201D i], button[aria-label*=\u201Dclose\u201D i], button:has(svg), .close, [data-close], .btn-close"
         );
         if (btn) {
           btn.click();
@@ -3054,8 +3144,12 @@ async function sweepOverlays(page, regex) {
       }
       return false;
     },
+    /* v8 ignore stop */
     [acceptRxSource, acceptRxFlags]
-  ).catch(() => false);
+  ).catch(
+    /* v8 ignore next */
+    () => false
+  );
 }
 async function suppressInterferences(page, opts = {}) {
   const timeoutMs = opts.timeoutMs ?? 4e3;