@letsrunit/playwright 0.8.0 → 0.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letsrunit/playwright",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "Playwright extensions and utilities for letsrunit",
   "keywords": [
     "testing",
@@ -42,7 +42,7 @@
   },
   "packageManager": "yarn@4.10.3",
   "dependencies": {
-    "@letsrunit/utils": "0.8.0",
+    "@letsrunit/utils": "0.9.1",
     "@playwright/test": "^1.57.0",
     "case": "^1.6.3",
     "diff": "^8.0.3",

package/src/fuzzy-locator.ts

@@ -1,26 +1,39 @@
 import { Locator, Page } from '@playwright/test';
 
+function debug(...args: unknown[]) {
+  if (process.env.LETSRUNIT_DEBUG_FUZZY_LOCATOR === '1') {
+    // eslint-disable-next-line no-console
+    console.log('[fuzzyLocator]', ...args);
+  }
+}
+
 /**
  * Locates an element using Playwright selectors, with lazy fallbacks.
  */
 export async function fuzzyLocator(page: Page, selector: string): Promise<Locator> {
+  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),
+  const candidates: Array<{ name: string; locator: Locator | null }> = [
+    { 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: string[] = [];
 
   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);
   }
+  debug('enabled fallbacks:', enabled.length ? enabled.join(', ') : '(none)');
 
-  return combined.first();
+  const result = combined.first();
+  debug('returning locator:', result.toString());
+  return result;
 }
 
 // Preserve the selector but relax [name="..."] to [has-text="..."]