@letsrunit/playwright 0.21.1 → 0.22.0

package/dist/index.js

@@ -27,10 +27,196 @@ async function browse(browser, options = {}) {
   return await context.newPage();
 }
 
+// src/fallback-locator.ts
+var FALLBACK_LOCATOR_CANDIDATES = /* @__PURE__ */ Symbol("letsrunit.playwright.fallback-locator-candidates");
+var ACTION_METHODS = /* @__PURE__ */ new Set([
+  "blur",
+  "check",
+  "clear",
+  "click",
+  "dblclick",
+  "dispatchEvent",
+  "dragTo",
+  "fill",
+  "focus",
+  "hover",
+  "press",
+  "pressSequentially",
+  "scrollIntoViewIfNeeded",
+  "selectOption",
+  "setChecked",
+  "setInputFiles",
+  "tap",
+  "type",
+  "uncheck"
+]);
+var LOCATOR_CHAIN_METHODS = /* @__PURE__ */ new Set([
+  "and",
+  "first",
+  "last",
+  "locator",
+  "nth",
+  "or"
+]);
+var NO_WAIT_OPTION_INDEX = {
+  dragTo: 1,
+  fill: 1,
+  press: 1,
+  pressSequentially: 1,
+  selectOption: 1,
+  setInputFiles: 1,
+  type: 1
+};
+function buildOrLocator(candidates) {
+  let result = candidates[0];
+  for (const candidate of candidates.slice(1)) {
+    result = result.or(candidate);
+  }
+  return result;
+}
+async function firstPresentFallback(candidates) {
+  for (const candidate of candidates.slice(1)) {
+    try {
+      if (await candidate.count() > 0) return candidate;
+    } catch {
+    }
+  }
+  return null;
+}
+function withNoWaitTimeout(method, args) {
+  const next = [...args];
+  const optionIndex = NO_WAIT_OPTION_INDEX[method] ?? 0;
+  const current = next[optionIndex];
+  if (current && typeof current === "object") {
+    next[optionIndex] = { ...current, timeout: 0 };
+  } else {
+    next[optionIndex] = { timeout: 0 };
+  }
+  return next;
+}
+function handleExpect(primary, candidates) {
+  return (expression, options) => {
+    if (expression.includes("to.be.visible") || expression.includes("to.be.attached")) {
+      return buildOrLocator(candidates)._expect(expression, options);
+    }
+    return primary._expect(expression, options);
+  };
+}
+function handleAll(candidates) {
+  return async () => {
+    const all = [];
+    for (const candidate of candidates) {
+      all.push(...await candidate.all());
+    }
+    return all;
+  };
+}
+function handleLocatorChain(prop, candidates) {
+  return (...args) => createFallbackLocator(
+    candidates.map((candidate) => {
+      const method = candidate[prop];
+      return method.apply(candidate, args);
+    })
+  );
+}
+function handleCount(primary, candidates) {
+  return async () => {
+    const primaryCount = await primary.count();
+    if (primaryCount > 0) return primaryCount;
+    const fallback = await firstPresentFallback(candidates);
+    if (!fallback) return primaryCount;
+    return fallback.count();
+  };
+}
+function handleAction(prop, primary, candidates, primaryMethod) {
+  return async (...args) => {
+    try {
+      return await primaryMethod.apply(primary, args);
+    } catch (error) {
+      const fallback = await firstPresentFallback(candidates);
+      if (!fallback) throw error;
+      const fallbackMethod = fallback[prop];
+      return fallbackMethod.apply(fallback, withNoWaitTimeout(prop, args));
+    }
+  };
+}
+function handleAsyncFallback(prop, primaryMethod, primary, candidates) {
+  return (...args) => {
+    const result = primaryMethod.apply(primary, args);
+    if (!result || typeof result !== "object" || typeof result.catch !== "function") {
+      return result;
+    }
+    return result.catch(async (error) => {
+      const fallback = await firstPresentFallback(candidates);
+      if (!fallback) throw error;
+      const fallbackMethod = fallback[prop];
+      return fallbackMethod.apply(fallback, args);
+    });
+  };
+}
+function formatLocatorChain(candidates) {
+  const parts = candidates.map((candidate) => candidate.toString());
+  if (parts.length === 0) return "";
+  if (parts.length === 1) return parts[0];
+  return `${parts[0]} {fuzzy}`;
+}
+function createFallbackLocator(candidates) {
+  const primary = candidates[0];
+  const unsupported = /* @__PURE__ */ new Set(["filter", "getByRole", "getByLabel"]);
+  const passthroughMetaProperties = /* @__PURE__ */ new Set(["constructor", "__proto__"]);
+  const proxy = new Proxy(primary, {
+    get(_target, prop) {
+      if (prop === FALLBACK_LOCATOR_CANDIDATES) return candidates;
+      if (typeof prop !== "string") return primary[prop];
+      if (passthroughMetaProperties.has(prop)) return primary[prop];
+      switch (prop) {
+        case "toString":
+          return () => formatLocatorChain(candidates);
+        case "all":
+          return handleAll(candidates);
+        case "_expect":
+          return handleExpect(primary, candidates);
+        case "count":
+          return handleCount(primary, candidates);
+      }
+      if (unsupported.has(prop)) {
+        return () => {
+          throw new Error(`FallbackLocator does not support ${prop}`);
+        };
+      }
+      if (LOCATOR_CHAIN_METHODS.has(prop)) {
+        return handleLocatorChain(prop, candidates);
+      }
+      const primaryMethod = primary[prop];
+      if (typeof primaryMethod !== "function") return primaryMethod;
+      if (ACTION_METHODS.has(prop)) {
+        return handleAction(prop, primary, candidates, primaryMethod);
+      }
+      return handleAsyncFallback(prop, primaryMethod, primary, candidates);
+    }
+  });
+  return proxy;
+}
+function getFallbackLocatorCandidates(locator) {
+  return locator[FALLBACK_LOCATOR_CANDIDATES] ?? null;
+}
+
 // src/utils/pick-field-element.ts
+async function resolveConcreteFieldLocator(elements) {
+  const fallbackCandidates = getFallbackLocatorCandidates(elements);
+  if (!fallbackCandidates) return elements;
+  for (const candidate of fallbackCandidates) {
+    try {
+      if (await candidate.count() > 0) return candidate;
+    } catch {
+    }
+  }
+  return elements;
+}
 async function pickFieldElement(elements) {
+  elements = await resolveConcreteFieldLocator(elements);
   const count = await elements.count();
-  if (count === 1) return elements;
+  if (count <= 1) return elements.first();
   const candidates = [];
   for (let i = 0; i < count; i++) {
     const el = elements.nth(i);
@@ -60,7 +246,7 @@ async function pickFieldElement(elements) {
   if (isParent !== null) {
     return elements.nth(isParent);
   }
-  return elements;
+  return elements.first();
 }
 
 // src/field/aria-select.ts
@@ -1744,9 +1930,7 @@ async function setFieldValue(el, value, options) {
     // fallback (eg contenteditable or will fail)
     setFallback
   );
-  if (await el.count() > 1) {
-    el = await pickFieldElement(el);
-  }
+  el = await pickFieldElement(el);
   const tag = await el.evaluate((e) => e.tagName.toLowerCase(), options);
   const type = (await el.getAttribute("type", options).catch(
     /* v8 ignore next — attribute might be missing or element might have detached during the check */
@@ -1761,175 +1945,6 @@ async function formatHtml(page) {
   return String(file);
 }
 
-// src/fallback-locator.ts
-var ACTION_METHODS = /* @__PURE__ */ new Set([
-  "blur",
-  "check",
-  "clear",
-  "click",
-  "dblclick",
-  "dispatchEvent",
-  "dragTo",
-  "fill",
-  "focus",
-  "hover",
-  "press",
-  "pressSequentially",
-  "scrollIntoViewIfNeeded",
-  "selectOption",
-  "setChecked",
-  "setInputFiles",
-  "tap",
-  "type",
-  "uncheck"
-]);
-var LOCATOR_CHAIN_METHODS = /* @__PURE__ */ new Set([
-  "and",
-  "first",
-  "last",
-  "locator",
-  "nth",
-  "or"
-]);
-var NO_WAIT_OPTION_INDEX = {
-  dragTo: 1,
-  fill: 1,
-  press: 1,
-  pressSequentially: 1,
-  selectOption: 1,
-  setInputFiles: 1,
-  type: 1
-};
-function buildOrLocator(candidates) {
-  let result = candidates[0];
-  for (const candidate of candidates.slice(1)) {
-    result = result.or(candidate);
-  }
-  return result;
-}
-async function firstPresentFallback(candidates) {
-  for (const candidate of candidates.slice(1)) {
-    try {
-      if (await candidate.count() > 0) return candidate;
-    } catch {
-    }
-  }
-  return null;
-}
-function withNoWaitTimeout(method, args) {
-  const next = [...args];
-  const optionIndex = NO_WAIT_OPTION_INDEX[method] ?? 0;
-  const current = next[optionIndex];
-  if (current && typeof current === "object") {
-    next[optionIndex] = { ...current, timeout: 0 };
-  } else {
-    next[optionIndex] = { timeout: 0 };
-  }
-  return next;
-}
-function handleExpect(primary, candidates) {
-  return (expression, options) => {
-    if (expression.includes("to.be.visible") || expression.includes("to.be.attached")) {
-      return buildOrLocator(candidates)._expect(expression, options);
-    }
-    return primary._expect(expression, options);
-  };
-}
-function handleAll(candidates) {
-  return async () => {
-    const all = [];
-    for (const candidate of candidates) {
-      all.push(...await candidate.all());
-    }
-    return all;
-  };
-}
-function handleLocatorChain(prop, candidates) {
-  return (...args) => createFallbackLocator(
-    candidates.map((candidate) => {
-      const method = candidate[prop];
-      return method.apply(candidate, args);
-    })
-  );
-}
-function handleCount(primary, candidates) {
-  return async () => {
-    const primaryCount = await primary.count();
-    if (primaryCount > 0) return primaryCount;
-    const fallback = await firstPresentFallback(candidates);
-    if (!fallback) return primaryCount;
-    return fallback.count();
-  };
-}
-function handleAction(prop, primary, candidates, primaryMethod) {
-  return async (...args) => {
-    try {
-      return await primaryMethod.apply(primary, args);
-    } catch (error) {
-      const fallback = await firstPresentFallback(candidates);
-      if (!fallback) throw error;
-      const fallbackMethod = fallback[prop];
-      return fallbackMethod.apply(fallback, withNoWaitTimeout(prop, args));
-    }
-  };
-}
-function handleAsyncFallback(prop, primaryMethod, primary, candidates) {
-  return (...args) => {
-    const result = primaryMethod.apply(primary, args);
-    if (!result || typeof result !== "object" || typeof result.catch !== "function") {
-      return result;
-    }
-    return result.catch(async (error) => {
-      const fallback = await firstPresentFallback(candidates);
-      if (!fallback) throw error;
-      const fallbackMethod = fallback[prop];
-      return fallbackMethod.apply(fallback, args);
-    });
-  };
-}
-function formatLocatorChain(candidates) {
-  const parts = candidates.map((candidate) => candidate.toString());
-  if (parts.length === 0) return "";
-  if (parts.length === 1) return parts[0];
-  return `${parts[0]} {fuzzy}`;
-}
-function createFallbackLocator(candidates) {
-  const primary = candidates[0];
-  const unsupported = /* @__PURE__ */ new Set(["filter", "getByRole", "getByLabel"]);
-  const passthroughMetaProperties = /* @__PURE__ */ new Set(["constructor", "__proto__"]);
-  const proxy = new Proxy(primary, {
-    get(_target, prop) {
-      if (typeof prop !== "string") return primary[prop];
-      if (passthroughMetaProperties.has(prop)) return primary[prop];
-      switch (prop) {
-        case "toString":
-          return () => formatLocatorChain(candidates);
-        case "all":
-          return handleAll(candidates);
-        case "_expect":
-          return handleExpect(primary, candidates);
-        case "count":
-          return handleCount(primary, candidates);
-      }
-      if (unsupported.has(prop)) {
-        return () => {
-          throw new Error(`FallbackLocator does not support ${prop}`);
-        };
-      }
-      if (LOCATOR_CHAIN_METHODS.has(prop)) {
-        return handleLocatorChain(prop, candidates);
-      }
-      const primaryMethod = primary[prop];
-      if (typeof primaryMethod !== "function") return primaryMethod;
-      if (ACTION_METHODS.has(prop)) {
-        return handleAction(prop, primary, candidates, primaryMethod);
-      }
-      return handleAsyncFallback(prop, primaryMethod, primary, candidates);
-    }
-  });
-  return proxy;
-}
-
 // src/fuzzy-locator.ts
 function debug(...args) {
   if (process.env.LETSRUNIT_DEBUG_FUZZY_LOCATOR === "1") {