@afixt/test-utils 2.0.0 → 2.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@afixt/test-utils",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "Various utilities for accessibility testing",
     "main": "src/index.js",
     "scripts": {

package/src/stringUtils.js

@@ -174,6 +174,40 @@ const stringUtils = (function () {
         return (element.textContent || '').trim();
     }
 
+    /**
+     * Checks if an accessible name contains the visible text as a whole-word phrase.
+     * Prevents false positives where aria-label is a superset of visible text
+     * (e.g. "Report a Concern Opens in new window" contains "Report a Concern").
+     * Uses word-boundary matching to avoid partial matches
+     * (e.g. "Homepage" does NOT contain "Home" as a whole word).
+     * @param {string} accessibleName - The accessible name (e.g. aria-label value)
+     * @param {string} visibleText - The visible text content of the element
+     * @returns {boolean} True if the accessible name contains the visible text at word boundaries
+     */
+    function containsVisibleText(accessibleName, visibleText) {
+        if (!accessibleName || !visibleText) {
+            return false;
+        }
+        const haystack = accessibleName.toLowerCase().replace(/\s+/g, ' ').trim();
+        const needle = visibleText.toLowerCase().replace(/\s+/g, ' ').trim();
+        if (!needle) {
+            return false;
+        }
+        const index = haystack.indexOf(needle);
+        if (index === -1) {
+            return false;
+        }
+        // Check word boundaries
+        if (index > 0 && /\w/.test(haystack.charAt(index - 1))) {
+            return false;
+        }
+        const endIndex = index + needle.length;
+        if (endIndex < haystack.length && /\w/.test(haystack.charAt(endIndex))) {
+            return false;
+        }
+        return true;
+    }
+
     /**
      * Checks if text contains a warning about new window/tab behavior.
      * @param {string} text - The text to check
@@ -211,6 +245,7 @@ const stringUtils = (function () {
         isGenericTitle,
         isGenericLinkText,
         getActualVisibleText,
+        containsVisibleText,
         hasNewWindowWarning,
     };
 })();

package/test/stringUtils.test.js

@@ -436,6 +436,66 @@ describe('stringUtils', () => {
         });
     });
 
+    describe('containsVisibleText', () => {
+        it('should return true when accessible name exactly matches visible text', () => {
+            expect(stringUtils.containsVisibleText('Home', 'Home')).toBe(true);
+        });
+
+        it('should return true when accessible name is a superset of visible text', () => {
+            expect(
+                stringUtils.containsVisibleText(
+                    'Report a Concern Opens in new window',
+                    'Report a Concern'
+                )
+            ).toBe(true);
+        });
+
+        it('should be case-insensitive', () => {
+            expect(stringUtils.containsVisibleText('REPORT A CONCERN', 'Report a Concern')).toBe(
+                true
+            );
+        });
+
+        it('should return false when visible text is a partial word match', () => {
+            expect(stringUtils.containsVisibleText('Homepage', 'Home')).toBe(false);
+        });
+
+        it('should return false when accessible name does not contain visible text', () => {
+            expect(
+                stringUtils.containsVisibleText('Click here for more information', 'Learn more')
+            ).toBe(false);
+        });
+
+        it('should return false for null/undefined inputs', () => {
+            expect(stringUtils.containsVisibleText(null, 'text')).toBe(false);
+            expect(stringUtils.containsVisibleText('text', null)).toBe(false);
+            expect(stringUtils.containsVisibleText(undefined, undefined)).toBe(false);
+        });
+
+        it('should return false for empty visible text', () => {
+            expect(stringUtils.containsVisibleText('some name', '')).toBe(false);
+            expect(stringUtils.containsVisibleText('some name', '   ')).toBe(false);
+        });
+
+        it('should normalize whitespace before matching', () => {
+            expect(stringUtils.containsVisibleText('Report  a   Concern', 'Report a Concern')).toBe(
+                true
+            );
+        });
+
+        it('should match visible text at the end of accessible name', () => {
+            expect(stringUtils.containsVisibleText('Click here to Search', 'Search')).toBe(true);
+        });
+
+        it('should not match across word boundaries at end', () => {
+            expect(stringUtils.containsVisibleText('Searching', 'Search')).toBe(false);
+        });
+
+        it('should handle visible text that is the entire accessible name', () => {
+            expect(stringUtils.containsVisibleText('Buy now', 'Buy now')).toBe(true);
+        });
+    });
+
     describe('hasNewWindowWarning', () => {
         it('should return true for text containing "new window"', () => {
             expect(stringUtils.hasNewWindowWarning('Opens in a new window')).toBe(true);