@afixt/test-utils 2.4.0 → 2.6.0

package/src/shadowDomUtils.js

@@ -111,8 +111,91 @@ function deepQuerySelectorAll(root, selector) {
     return results;
 }
 
+/**
+ * Recursively extracts text content from an element, crossing open shadow
+ * DOM boundaries.  For closed shadow roots the host element's light-DOM
+ * `textContent` is used (the shadow internals are inaccessible by spec).
+ *
+ * @param {Element} element - The element to extract text from.
+ * @returns {string} The concatenated, whitespace-normalised text.
+ */
+function getDeepTextContent(element) {
+    if (!element) {
+        return '';
+    }
+
+    const parts = [];
+
+    /**
+     * Walk every child node, descending into open shadow roots.
+     * @param {Node} node - Current node in the walk.
+     */
+    function walk(node) {
+        // If this element has an open shadow root, walk its shadow children
+        // instead of (or in addition to) the light DOM children.
+        if (node.nodeType === Node.ELEMENT_NODE && node.shadowRoot) {
+            for (let sc = node.shadowRoot.firstChild; sc; sc = sc.nextSibling) {
+                walk(sc);
+            }
+            // Also walk slotted light-DOM children
+            for (let lc = node.firstChild; lc; lc = lc.nextSibling) {
+                walk(lc);
+            }
+            return;
+        }
+
+        if (node.nodeType === Node.TEXT_NODE) {
+            const text = node.nodeValue;
+            if (text && text.trim()) {
+                parts.push(text.trim());
+            }
+            return;
+        }
+
+        if (node.nodeType === Node.ELEMENT_NODE) {
+            for (let child = node.firstChild; child; child = child.nextSibling) {
+                walk(child);
+            }
+        }
+    }
+
+    walk(element);
+    return parts.join(' ').replace(/\s+/g, ' ').trim();
+}
+
+/**
+ * Checks whether an element or any of its descendants is a custom element
+ * (has a hyphen in its tag name per the HTML spec).
+ *
+ * Useful for detecting elements that *may* contain shadow DOM content
+ * which is inaccessible via `textContent` or `querySelectorAll`.
+ *
+ * @param {Element} element - The element to inspect.
+ * @returns {boolean} True if the element itself or a descendant is a custom element.
+ */
+function hasCustomElementDescendant(element) {
+    if (!element) {
+        return false;
+    }
+
+    if (element.tagName && element.tagName.indexOf('-') !== -1) {
+        return true;
+    }
+
+    const children = element.querySelectorAll ? element.querySelectorAll('*') : [];
+    for (let i = 0; i < children.length; i++) {
+        if (children[i].tagName && children[i].tagName.indexOf('-') !== -1) {
+            return true;
+        }
+    }
+
+    return false;
+}
+
 module.exports = {
     deepGetElementById,
     deepQuerySelector,
     deepQuerySelectorAll,
+    getDeepTextContent,
+    hasCustomElementDescendant,
 };

package/src/stringUtils.js

@@ -167,6 +167,8 @@ const stringUtils = (function () {
 
     /**
      * Get the actual visible text content of an element, ignoring aria-label.
+     * Traverses open shadow DOM boundaries so that text rendered inside
+     * web components is included.
      * @param {Element} element - The DOM element
      * @returns {string} The visible text content
      */
@@ -174,7 +176,14 @@ const stringUtils = (function () {
         if (!element) {
             return '';
         }
-        return (element.textContent || '').trim();
+        // Fast path: no shadow roots in subtree
+        const text = (element.textContent || '').trim();
+        if (text) {
+            return text;
+        }
+        // Slow path: element may contain custom elements with shadow DOM
+        const { getDeepTextContent } = require('./shadowDomUtils.js');
+        return getDeepTextContent(element);
     }
 
     /**