npm - @afixt/test-utils - Versions diffs - 1.0.0 - Mend

@afixt/test-utils 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (132) hide show

package/.editorconfig +13 -0
package/.eslintrc +78 -0
package/.gitattributes +5 -0
package/.nvmrc +1 -0
package/CLAUDE.md +33 -0
package/README.md +72 -0
package/docs/arrayUtils.js.html +69 -0
package/docs/data/search.json +1 -0
package/docs/domUtils.js.html +182 -0
package/docs/fonts/Inconsolata-Regular.ttf +0 -0
package/docs/fonts/OpenSans-Regular.ttf +0 -0
package/docs/fonts/WorkSans-Bold.ttf +0 -0
package/docs/getAccessibleName.js.html +456 -0
package/docs/getAccessibleText.js.html +65 -0
package/docs/getAriaAttributesByElement.js.html +22 -0
package/docs/getCSSGeneratedContent.js.html +62 -0
package/docs/getComputedRole.js.html +172 -0
package/docs/getFocusableElements.js.html +29 -0
package/docs/getGeneratedContent.js.html +18 -0
package/docs/getImageText.js.html +28 -0
package/docs/getStyleObject.js.html +48 -0
package/docs/global.html +3 -0
package/docs/hasAccessibleName.js.html +30 -0
package/docs/hasAttribute.js.html +18 -0
package/docs/hasCSSGeneratedContent.js.html +23 -0
package/docs/hasHiddenParent.js.html +32 -0
package/docs/hasParent.js.html +57 -0
package/docs/hasValidAriaAttributes.js.html +33 -0
package/docs/hasValidAriaRole.js.html +32 -0
package/docs/index.html +3 -0
package/docs/index.js.html +66 -0
package/docs/isAriaAttributesValid.js.html +76 -0
package/docs/isComplexTable.js.html +112 -0
package/docs/isDataTable.js.html +241 -0
package/docs/isFocusable.js.html +37 -0
package/docs/isHidden.js.html +20 -0
package/docs/isOffScreen.js.html +19 -0
package/docs/isValidUrl.js.html +16 -0
package/docs/isVisible.js.html +65 -0
package/docs/module-afixt-test-utils.html +3 -0
package/docs/scripts/core.js +726 -0
package/docs/scripts/core.min.js +23 -0
package/docs/scripts/resize.js +90 -0
package/docs/scripts/search.js +265 -0
package/docs/scripts/search.min.js +6 -0
package/docs/scripts/third-party/Apache-License-2.0.txt +202 -0
package/docs/scripts/third-party/fuse.js +9 -0
package/docs/scripts/third-party/hljs-line-num-original.js +369 -0
package/docs/scripts/third-party/hljs-line-num.js +1 -0
package/docs/scripts/third-party/hljs-original.js +5171 -0
package/docs/scripts/third-party/hljs.js +1 -0
package/docs/scripts/third-party/popper.js +5 -0
package/docs/scripts/third-party/tippy.js +1 -0
package/docs/scripts/third-party/tocbot.js +672 -0
package/docs/scripts/third-party/tocbot.min.js +1 -0
package/docs/styles/clean-jsdoc-theme-base.css +1159 -0
package/docs/styles/clean-jsdoc-theme-dark.css +412 -0
package/docs/styles/clean-jsdoc-theme-light.css +482 -0
package/docs/styles/clean-jsdoc-theme-scrollbar.css +30 -0
package/docs/styles/clean-jsdoc-theme-without-scrollbar.min.css +1 -0
package/docs/styles/clean-jsdoc-theme.min.css +1 -0
package/docs/testContrast.js.html +236 -0
package/docs/testLang.js.html +578 -0
package/docs/testOrder.js.html +93 -0
package/jsdoc.json +67 -0
package/package.json +32 -0
package/src/arrayUtils.js +67 -0
package/src/domUtils.js +179 -0
package/src/getAccessibleName.js +454 -0
package/src/getAccessibleText.js +63 -0
package/src/getAriaAttributesByElement.js +19 -0
package/src/getCSSGeneratedContent.js +60 -0
package/src/getComputedRole.js +169 -0
package/src/getFocusableElements.js +26 -0
package/src/getGeneratedContent.js +15 -0
package/src/getImageText.js +25 -0
package/src/getStyleObject.js +45 -0
package/src/hasAccessibleName.js +28 -0
package/src/hasAttribute.js +15 -0
package/src/hasCSSGeneratedContent.js +20 -0
package/src/hasHiddenParent.js +29 -0
package/src/hasParent.js +54 -0
package/src/hasValidAriaAttributes.js +30 -0
package/src/hasValidAriaRole.js +29 -0
package/src/index.js +64 -0
package/src/interactiveRoles.js +20 -0
package/src/isAriaAttributesValid.js +74 -0
package/src/isComplexTable.js +109 -0
package/src/isDataTable.js +239 -0
package/src/isFocusable.js +34 -0
package/src/isHidden.js +17 -0
package/src/isOffScreen.js +16 -0
package/src/isValidUrl.js +13 -0
package/src/isVisible.js +62 -0
package/src/stringUtils.js +150 -0
package/src/testContrast.js +233 -0
package/src/testLang.js +575 -0
package/src/testOrder.js +90 -0
package/test/_template.test.js +21 -0
package/test/arrayUtils.test.js +84 -0
package/test/domUtils.test.js +147 -0
package/test/generate-test-stubs.js +37 -0
package/test/getAccessibleName.test.js +113 -0
package/test/getAccessibleText.test.js +94 -0
package/test/getAriaAttributesByElement.test.js +112 -0
package/test/getCSSGeneratedContent.test.js +102 -0
package/test/getComputedRole.test.js +180 -0
package/test/getFocusableElements.test.js +134 -0
package/test/getGeneratedContent.test.js +321 -0
package/test/getImageText.test.js +21 -0
package/test/getStyleObject.test.js +134 -0
package/test/hasAccessibleName.test.js +59 -0
package/test/hasAttribute.test.js +132 -0
package/test/hasCSSGeneratedContent.test.js +143 -0
package/test/hasHiddenParent.test.js +176 -0
package/test/hasParent.test.js +266 -0
package/test/hasValidAriaAttributes.test.js +79 -0
package/test/hasValidAriaRole.test.js +98 -0
package/test/isAriaAttributesValid.test.js +83 -0
package/test/isComplexTable.test.js +363 -0
package/test/isDataTable.test.js +948 -0
package/test/isFocusable.test.js +182 -0
package/test/isHidden.test.js +157 -0
package/test/isOffScreen.test.js +249 -0
package/test/isValidUrl.test.js +63 -0
package/test/isVisible.test.js +104 -0
package/test/setup.js +11 -0
package/test/stringUtils.test.js +106 -0
package/test/testContrast.test.js +77 -0
package/test/testLang.test.js +21 -0
package/test/testOrder.test.js +157 -0
package/vitest.config.js +25 -0

package/docs/getAccessibleName.js.html ADDED Viewed

@@ -0,0 +1,456 @@
+<!DOCTYPE html><html lang="en" style="font-size:16px"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Source: getAccessibleName.js</title><!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]--><script src="scripts/third-party/hljs.js" defer="defer"></script><script src="scripts/third-party/hljs-line-num.js" defer="defer"></script><script src="scripts/third-party/popper.js" defer="defer"></script><script src="scripts/third-party/tippy.js" defer="defer"></script><script src="scripts/third-party/tocbot.min.js"></script><script>var baseURL="/",locationPathname="";baseURL=(locationPathname=document.location.pathname).substr(0,locationPathname.lastIndexOf("/")+1)</script><link rel="stylesheet" href="styles/clean-jsdoc-theme.min.css"><svg aria-hidden="true" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="display:none"><defs><symbol id="copy-icon" viewbox="0 0 488.3 488.3"><g><path d="M314.25,85.4h-227c-21.3,0-38.6,17.3-38.6,38.6v325.7c0,21.3,17.3,38.6,38.6,38.6h227c21.3,0,38.6-17.3,38.6-38.6V124    C352.75,102.7,335.45,85.4,314.25,85.4z M325.75,449.6c0,6.4-5.2,11.6-11.6,11.6h-227c-6.4,0-11.6-5.2-11.6-11.6V124    c0-6.4,5.2-11.6,11.6-11.6h227c6.4,0,11.6,5.2,11.6,11.6V449.6z"/><path d="M401.05,0h-227c-21.3,0-38.6,17.3-38.6,38.6c0,7.5,6,13.5,13.5,13.5s13.5-6,13.5-13.5c0-6.4,5.2-11.6,11.6-11.6h227    c6.4,0,11.6,5.2,11.6,11.6v325.7c0,6.4-5.2,11.6-11.6,11.6c-7.5,0-13.5,6-13.5,13.5s6,13.5,13.5,13.5c21.3,0,38.6-17.3,38.6-38.6    V38.6C439.65,17.3,422.35,0,401.05,0z"/></g></symbol><symbol id="search-icon" viewBox="0 0 512 512"><g><g><path d="M225.474,0C101.151,0,0,101.151,0,225.474c0,124.33,101.151,225.474,225.474,225.474    c124.33,0,225.474-101.144,225.474-225.474C450.948,101.151,349.804,0,225.474,0z M225.474,409.323    c-101.373,0-183.848-82.475-183.848-183.848S124.101,41.626,225.474,41.626s183.848,82.475,183.848,183.848    S326.847,409.323,225.474,409.323z"/></g></g><g><g><path d="M505.902,476.472L386.574,357.144c-8.131-8.131-21.299-8.131-29.43,0c-8.131,8.124-8.131,21.306,0,29.43l119.328,119.328    c4.065,4.065,9.387,6.098,14.715,6.098c5.321,0,10.649-2.033,14.715-6.098C514.033,497.778,514.033,484.596,505.902,476.472z"/></g></g></symbol><symbol id="font-size-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11.246 15H4.754l-2 5H.6L7 4h2l6.4 16h-2.154l-2-5zm-.8-2L8 6.885 5.554 13h4.892zM21 12.535V12h2v8h-2v-.535a4 4 0 1 1 0-6.93zM19 18a2 2 0 1 0 0-4 2 2 0 0 0 0 4z"/></symbol><symbol id="add-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11 11V5h2v6h6v2h-6v6h-2v-6H5v-2z"/></symbol><symbol id="minus-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M5 11h14v2H5z"/></symbol><symbol id="dark-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M10 7a7 7 0 0 0 12 4.9v.1c0 5.523-4.477 10-10 10S2 17.523 2 12 6.477 2 12 2h.1A6.979 6.979 0 0 0 10 7zm-6 5a8 8 0 0 0 15.062 3.762A9 9 0 0 1 8.238 4.938 7.999 7.999 0 0 0 4 12z"/></symbol><symbol id="light-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 18a6 6 0 1 1 0-12 6 6 0 0 1 0 12zm0-2a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM11 1h2v3h-2V1zm0 19h2v3h-2v-3zM3.515 4.929l1.414-1.414L7.05 5.636 5.636 7.05 3.515 4.93zM16.95 18.364l1.414-1.414 2.121 2.121-1.414 1.414-2.121-2.121zm2.121-14.85l1.414 1.415-2.121 2.121-1.414-1.414 2.121-2.121zM5.636 16.95l1.414 1.414-2.121 2.121-1.414-1.414 2.121-2.121zM23 11v2h-3v-2h3zM4 11v2H1v-2h3z"/></symbol><symbol id="reset-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M18.537 19.567A9.961 9.961 0 0 1 12 22C6.477 22 2 17.523 2 12S6.477 2 12 2s10 4.477 10 10c0 2.136-.67 4.116-1.81 5.74L17 12h3a8 8 0 1 0-2.46 5.772l.997 1.795z"/></symbol><symbol id="down-icon" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M12.7803 6.21967C13.0732 6.51256 13.0732 6.98744 12.7803 7.28033L8.53033 11.5303C8.23744 11.8232 7.76256 11.8232 7.46967 11.5303L3.21967 7.28033C2.92678 6.98744 2.92678 6.51256 3.21967 6.21967C3.51256 5.92678 3.98744 5.92678 4.28033 6.21967L8 9.93934L11.7197 6.21967C12.0126 5.92678 12.4874 5.92678 12.7803 6.21967Z"></path></symbol><symbol id="codepen-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M16.5 13.202L13 15.535v3.596L19.197 15 16.5 13.202zM14.697 12L12 10.202 9.303 12 12 13.798 14.697 12zM20 10.869L18.303 12 20 13.131V10.87zM19.197 9L13 4.869v3.596l3.5 2.333L19.197 9zM7.5 10.798L11 8.465V4.869L4.803 9 7.5 10.798zM4.803 15L11 19.131v-3.596l-3.5-2.333L4.803 15zM4 13.131L5.697 12 4 10.869v2.262zM2 9a1 1 0 0 1 .445-.832l9-6a1 1 0 0 1 1.11 0l9 6A1 1 0 0 1 22 9v6a1 1 0 0 1-.445.832l-9 6a1 1 0 0 1-1.11 0l-9-6A1 1 0 0 1 2 15V9z"/></symbol><symbol id="close-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 10.586l4.95-4.95 1.414 1.414-4.95 4.95 4.95 4.95-1.414 1.414-4.95-4.95-4.95 4.95-1.414-1.414 4.95-4.95-4.95-4.95L7.05 5.636z"/></symbol><symbol id="menu-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M3 4h18v2H3V4zm0 7h18v2H3v-2zm0 7h18v2H3v-2z"/></symbol></defs></svg></head><body data-theme="dark"><div class="sidebar-container"><div class="sidebar" id="sidebar"><div class="sidebar-items-container"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-afixt-test-utils.html">afixt-test-utils</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#arrayCount">arrayCount</a></div><div class="sidebar-section-children"><a href="global.html#arrayRemoveByValue">arrayRemoveByValue</a></div><div class="sidebar-section-children"><a href="global.html#arrayUnique">arrayUnique</a></div><div class="sidebar-section-children"><a href="global.html#cellColorDiffs">cellColorDiffs</a></div><div class="sidebar-section-children"><a href="global.html#cellCount">cellCount</a></div><div class="sidebar-section-children"><a href="global.html#checkInconsistent">checkInconsistent</a></div><div class="sidebar-section-children"><a href="global.html#checkMultiRowsInHeader">checkMultiRowsInHeader</a></div><div class="sidebar-section-children"><a href="global.html#checkMultiRowsWithColspan">checkMultiRowsWithColspan</a></div><div class="sidebar-section-children"><a href="global.html#cleanBlank">cleanBlank</a></div><div class="sidebar-section-children"><a href="global.html#colCount">colCount</a></div><div class="sidebar-section-children"><a href="global.html#countBordersPct">countBordersPct</a></div><div class="sidebar-section-children"><a href="global.html#getAccessibleName">getAccessibleName</a></div><div class="sidebar-section-children"><a href="global.html#getAccessibleText">getAccessibleText</a></div><div class="sidebar-section-children"><a href="global.html#getAriaAttributes">getAriaAttributes</a></div><div class="sidebar-section-children"><a href="global.html#getCSSGeneratedContent">getCSSGeneratedContent</a></div><div class="sidebar-section-children"><a href="global.html#getColorContrast">getColorContrast</a></div><div class="sidebar-section-children"><a href="global.html#getComputedBackgroundColor">getComputedBackgroundColor</a></div><div class="sidebar-section-children"><a href="global.html#getComputedRole">getComputedRole</a></div><div class="sidebar-section-children"><a href="global.html#getFocusableElements">getFocusableElements</a></div><div class="sidebar-section-children"><a href="global.html#getGeneratedContent">getGeneratedContent</a></div><div class="sidebar-section-children"><a href="global.html#getImageText">getImageText</a></div><div class="sidebar-section-children"><a href="global.html#getStyleObject">getStyleObject</a></div><div class="sidebar-section-children"><a href="global.html#getTwoLetterCode">getTwoLetterCode</a></div><div class="sidebar-section-children"><a href="global.html#hasAccessibleName">hasAccessibleName</a></div><div class="sidebar-section-children"><a href="global.html#hasAttribute">hasAttribute</a></div><div class="sidebar-section-children"><a href="global.html#hasCSSGeneratedContent">hasCSSGeneratedContent</a></div><div class="sidebar-section-children"><a href="global.html#hasHiddenParent">hasHiddenParent</a></div><div class="sidebar-section-children"><a href="global.html#hasParent">hasParent</a></div><div class="sidebar-section-children"><a href="global.html#hasValidAriaAttributes">hasValidAriaAttributes</a></div><div class="sidebar-section-children"><a href="global.html#hasValidAriaRole">hasValidAriaRole</a></div><div class="sidebar-section-children"><a href="global.html#isAriaAttributeValid">isAriaAttributeValid</a></div><div class="sidebar-section-children"><a href="global.html#isComplexTable">isComplexTable</a></div><div class="sidebar-section-children"><a href="global.html#isDataTable">isDataTable</a></div><div class="sidebar-section-children"><a href="global.html#isFocusable">isFocusable</a></div><div class="sidebar-section-children"><a href="global.html#isHidden">isHidden</a></div><div class="sidebar-section-children"><a href="global.html#isNotVisible">isNotVisible</a></div><div class="sidebar-section-children"><a href="global.html#isOffScreen">isOffScreen</a></div><div class="sidebar-section-children"><a href="global.html#isValidUrl">isValidUrl</a></div><div class="sidebar-section-children"><a href="global.html#isVisible">isVisible</a></div><div class="sidebar-section-children"><a href="global.html#langCodes">langCodes</a></div><div class="sidebar-section-children"><a href="global.html#luminance">luminance</a></div><div class="sidebar-section-children"><a href="global.html#matchesSelector">matchesSelector</a></div><div class="sidebar-section-children"><a href="global.html#parseRGB">parseRGB</a></div><div class="sidebar-section-children"><a href="global.html#rowCount">rowCount</a></div><div class="sidebar-section-children"><a href="global.html#rtls">rtls</a></div><div class="sidebar-section-children"><a href="global.html#sortByVisualOrder">sortByVisualOrder</a></div><div class="sidebar-section-children"><a href="global.html#strlen">strlen</a></div><div class="sidebar-section-children"><a href="global.html#testContrast">testContrast</a></div><div class="sidebar-section-children"><a href="global.html#testLang">testLang</a></div><div class="sidebar-section-children"><a href="global.html#testOrder">testOrder</a></div><div class="sidebar-section-children"><a href="global.html#validAriaAttributes">validAriaAttributes</a></div><div class="sidebar-section-children"><a href="global.html#validLangCodes">validLangCodes</a></div></div></div></div></div><div class="navbar-container" id="VuAckcnZhf"><nav class="navbar"><div class="navbar-left-items"></div><div class="navbar-right-items"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#light-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div><nav></nav></nav></div><div class="toc-container"><div class="toc-content"><span class="bold">On this page</span><div id="eed4d2a0bfd64539bb9df78095dec881"></div></div></div><div class="body-wrapper"><div class="main-content"><div class="main-wrapper"><section id="source-page" class="source-page"><header><h1 id="title" class="has-anchor">getAccessibleName.js</h1></header><article><pre class="prettyprint source lang-js"><code>import { isEmpty } from "./stringUtils.js";
+import { getAccessibleText } from "./getAccessibleText.js";
+/**
+ * Gets the accessible name of an element according to the accessible name calculation algorithm
+ * @param {Element} element - The DOM element to get the accessible name for
+ * @returns {string|boolean} The accessible name or false if none exists
+ */
+function getAccessibleName(element) {
+    if (!element) return false;
+    // These are elements which are totally not able to be labeled at all.
+    // Even if the title attribute is valid per HTML for these elements,
+    // the title won't be used in any meaningful way by Accessibility APIs
+    const unlabellable =
+        "head *, hr, param, caption, colgroup, col, tbody, tfoot, thead, tr";
+    // STEP 0 - verify item is visible and can be labelled
+    // if it isn't visible or can't be labelled then just bail
+    if (isNotVisible(element) || matchesSelector(element, unlabellable)) {
+        return false;
+    }
+    let id, ids, label;
+    // STEP 1 - always check for aria-labelledby first
+    // STEP 1.1 - if aria-labelledby exists, check that the referenced element exists
+    // STEP 1.1.1 - return the text from the referenced item
+    if (element.hasAttribute("aria-labelledby")) {
+        ids = element.getAttribute("aria-labelledby").trim().split(" ");
+        const text = [];
+        for (const id of ids) {
+            const labelElement = document.getElementById(id);
+            if (!labelElement || !getAccessibleText(labelElement)) {
+                return false;
+            }
+            text.push(getAccessibleText(labelElement));
+        }
+        return text.join(" ");
+    }
+    // STEP 2 - (next) always check for aria-label second
+    // STEP 2.1 - if aria-label exists, return the text in it
+    if (element.hasAttribute("aria-label")) {
+        const ariaLabel = element.getAttribute("aria-label");
+        if (ariaLabel) {
+            return ariaLabel;
+        }
+        // there is no 'else' here because an empty aria-label is/ should be ignored and calculation continued
+    }
+    // STEP 3 - When it comes to AT, an object's ARIA role overrides native semantics for the object.
+    // Most ARIA controls/ widgets rely on labelling per steps 1 &amp; 2 above.
+    // If a label isn't found in Step 1 &amp; 2, we can (for some roles) use DOM subtree content to find the label.
+    // We check all of those here.
+    if (element.hasAttribute("role")) {
+        const roleValue = element.getAttribute("role");
+        const textRoles = [
+            "button", "checkbox", "columnheader", "gridcell", "heading", "link",
+            "listitem", "menuitem", "menuitemcheckbox", "menuitemradio", "option",
+            "radio", "row", "rowgroup", "rowheader", "tab", "tooltip", "treeitem"
+        ];
+        if (textRoles.includes(roleValue)) {
+            // quick sanity check to make sure the object can hold text in the first place and that it actually has text in it
+            if (!isEmpty(element.textContent)) {
+                return getAccessibleText(element);
+            }
+        }
+    }
+    // STEP 4: is the tag one of:
+    // input without any type, input type="text", input type="email", input type="password", input type="search", input type="tel", input type="url" and textarea element
+    // STEP 4.1 use the associated label
+    // STEP 4.3 Otherwise use the title attribute
+    // STEP 4.4 - return false. If none of the above yield a usable text string there is no accessible name
+    if (
+        matchesSelector(element,
+            'input:not([type]), input[type="text"], input[type="email"], input[type="password"], input[type="search"], input[type="tel"], input[type="url"], textarea'
+        )
+    ) {
+        // first we choose the explicit relationship over all others.
+        if (element.id &amp;&amp; document.querySelector('label[for="' + element.id + '"]')) {
+            id = element.id;
+            // Use only the *first* label that matches this ID.
+            // Sometimes JS libraries screw this up by hiding one of the labels or misnaming one
+            label = document.querySelector('label[for="' + id + '"]');
+            if (label) {
+                return getAccessibleText(label);
+            }
+        }
+        // if the element's parent is a label, use the text in that
+        else if (element.closest("label")) {
+            return getAccessibleText(element.closest("label"));
+        }
+        // title attribute is last resort
+        else if (element.hasAttribute("title")) {
+            if (strlen(element.getAttribute("title")) > 0) {
+                return element.getAttribute("title");
+            } else {
+                return false;
+            }
+        }
+        //if we got this far, there is no accessible name for this type of element
+        else {
+            return false;
+        }
+    }
+    // STEP 5: is the tag one of:
+    // input type="button", input type="submit" and input type="reset"
+    // STEP 5.1 use the value attribute
+    // STEP 5.2 For input type=submit: return localized string of the word "submit"
+    // STEP 5.3 For input type=reset: return localized string of the word "reset"
+    // STEP 5.4 For input type=button: return title attribute
+    // STEP 5.5 - return false. If none of the above yield a usable text string there is no accessible name
+    if (
+        matchesSelector(element,
+            'input[type="button"], input[type="submit"], input[type="reset"]'
+        )
+    ) {
+        if (element.hasAttribute("value")) {
+            if (element.getAttribute("value")) {
+                return element.getAttribute("value");
+            }
+        } else if (matchesSelector(element, 'input[type="button"]')) {
+            if (element.hasAttribute("title")) {
+                return element.getAttribute("title");
+            }
+            return false;
+        }
+        // We really have no guarantee that these *specific* default values will be used by the browser
+        // And these return values are especially not accurate for non-english users,
+        // but we make a safe guess here anyway because getting the real name involves inspecting the Shadow DOM
+        // which we cannot do
+        else if (matchesSelector(element, 'input[type="submit"]')) {
+            if (element.hasAttribute("title")) {
+                return element.getAttribute("title");
+            } else {
+                return "Submit";
+            }
+        } else if (matchesSelector(element, 'input[type="reset"]')) {
+            if (element.hasAttribute("title")) {
+                return element.getAttribute("title");
+            } else {
+                return "Reset";
+            }
+        }
+    }
+    // STEP 6: input type="image"
+    // STEP 6.1: use alt attribute
+    // STEP 6.2: value attribute
+    // STEP 6.3: Otherwise the user agent may provide an accessible name via a localized string of the phrase "Submit Query"
+    // STEP 6.4: Otherwise use title attribute
+    // STEP 6.5: return false. If none of the above yield a usable text string there is no accessible name
+    if (matchesSelector(element, 'input[type="image"]')) {
+        if (element.hasAttribute("alt")) {
+            return element.getAttribute("alt");
+        } else if (element.hasAttribute("value")) {
+            return element.getAttribute("value");
+        } else if (element.hasAttribute("title")) {
+            return element.getAttribute("title");
+        } else {
+            return false;
+        }
+    }
+    // STEP 7: button element
+    // STEP 7.1: use the button element subtree
+    // STEP 7.2: use title attribute
+    // STEP 7.3: return false. If none of the above yield a usable text string there is no accessible name
+    if (element.tagName.toLowerCase() === "button") {
+        if (strlen(getAccessibleText(element)) > 0) {
+            return getAccessibleText(element);
+        } else if (element.hasAttribute("title")) {
+            return element.getAttribute("title");
+        } else {
+            return false;
+        }
+    }
+    // STEP 8: Other form elements
+    // STEP 8.1: use label element
+    // STEP 8.2: use title attribute
+    // STEP 8.3: return false. If none of the above yield a usable text string there is no accessible name
+    if (
+        matchesSelector(element,
+            'select, input[type="checkbox"], input[type="color"], input[type="date"], input[type="datetime"], input[type="datetime-local"], input[type="email"], input[type="file"], input[type="month"], input[type="number"], input[type="radio"], input[type="range"], input[type="time"], input[type="week"]'
+        )
+    ) {
+        // first we choose the explicit relationship over all others.
+        if (element.id &amp;&amp; document.querySelector('label[for="' + element.id + '"]')) {
+            id = element.id;
+            //Use only the *first* label that matches this ID. Sometimes ppl screw this up
+            label = document.querySelector('label[for="' + id + '"]');
+            if (label) {
+                return getAccessibleText(label);
+            }
+        }
+        // if the element's parent is a label, use the text in that
+        else if (element.closest("label")) {
+            return getAccessibleText(element.closest("label"));
+        }
+        // title attribute is last resort
+        else if (element.hasAttribute("title")) {
+            return element.getAttribute("title");
+        }
+        //if we got this far, there is no accessible name
+        else {
+            return false;
+        }
+    }
+    // STEP 9: summary element
+    // STEP 9.1: use summary element subtree
+    // STEP 9.2: Otherwise use title attribute
+    // STEP 9.3: default: If none of the above yield a usable text string
+    // the user agent should provide its own text string (e.g. "Details")
+    // We really have no guarantee that these *specific* default values
+    // will be used by the browser
+    // And these return values are especially not accurate for
+    // non-english users, but we make a safe guess here anyway because
+    // like Submit buttons, getting the real value involves inspecting Shadow DOM
+    if (element.tagName.toLowerCase() === "details") {
+        const summary = element.querySelector("summary");
+        if (summary) {
+            if (strlen(getAccessibleText(summary)) > 0) {
+                return getAccessibleText(summary);
+            }
+        } else if (element.hasAttribute("title")) {
+            if (strlen(element.getAttribute("title")) > 0) {
+                return element.getAttribute("title");
+            } else {
+                return "Details";
+            }
+        } else {
+            return "Details";
+        }
+    }
+    // STEP 10: figure (and figcaption) elements
+    // STEP 10.1: figcaption subtree
+    // STEP 10.2: title attribute
+    // STEP 10.3: return false. If none of the above yield a usable text
+    // string there is no accessible name
+    if (element.tagName.toLowerCase() === "figure") {
+        const figcaption = element.querySelector("figcaption");
+        if (figcaption) {
+            if (strlen(getAccessibleText(figcaption)) > 0) {
+                return getAccessibleText(figcaption);
+            }
+        } else if (element.hasAttribute("title")) {
+            return element.getAttribute("title");
+        } else {
+            return false;
+        }
+    }
+    // STEP 11: img element
+    // STEP 11.1: use alt attribute
+    // STEP 11.2: use title attribute
+    // STEP 11.3: return false. If none of the above yield a usable
+    // text string there is no accessible name
+    if (element.tagName.toLowerCase() === "img") {
+        if (element.hasAttribute("alt")) {
+            return element.getAttribute("alt");
+        } else if (element.hasAttribute("title")) {
+            return element.getAttribute("title");
+        } else {
+            return false;
+        }
+    }
+    // STEP 11-1: area element that is linked
+    // STEP 11-1.1: use alt attribute
+    // STEP 11-1.2: use title attribute
+    // STEP 11-1.3: return false. If none of the above yield a usable
+    // text string there is no accessible name
+    if (matchesSelector(element, "area[href]")) {
+        if (element.hasAttribute("alt")) {
+            return element.getAttribute("alt");
+        } else if (element.hasAttribute("title")) {
+            return element.getAttribute("title");
+        } else {
+            return false;
+        }
+    }
+    // STEP 11-2: applet element
+    // STEP 11-2.1: use alt attribute
+    // STEP 11-2.3: return false. If none of the above yield a usable
+    // text string there is no accessible name
+    if (element.tagName.toLowerCase() === "applet") {
+        if (element.hasAttribute("alt")) {
+            return element.getAttribute("alt");
+        } else {
+            return false;
+        }
+    }
+    // STEP 12: table element
+    // STEP 12.1: caption element
+    // STEP 12.2: use the title attribute
+    // STEP 12.3: use the summary attribute
+    // STEP 12.4: return false. If none of the above yield a usable
+    // text string there is no accessible name
+    if (element.tagName.toLowerCase() === "table") {
+        const caption = element.querySelector("caption");
+        if (caption) {
+            if (strlen(getAccessibleText(caption)) > 0) {
+                return getAccessibleText(caption);
+            }
+        } else if (element.hasAttribute("title")) {
+            return element.getAttribute("title");
+        } else if (element.hasAttribute("summary")) {
+            return element.getAttribute("summary");
+        }
+        return false;
+    }
+    // STEP 13: a element that is linked
+    // STEP 13.1: use a element subtree
+    // STEP 13.2: the title attribute
+    // STEP 13.3: return false. If none of the above yield a usable
+    // text string there is no accessible name
+    if (matchesSelector(element, "a[href]")) {
+        if (strlen(getAccessibleText(element)) > 0) {
+            return getAccessibleText(element);
+        } else if (element.hasAttribute("title")) {
+            return element.getAttribute("title");
+        } else {
+            return false;
+        }
+    }
+    // STEP 14: Text level elements not listed elsewhere
+    // STEP 14.0: must be one of: em, strong, small, s, cite, q, dfn,
+    // abbr, time, code, var, samp, kbd, sub and sup, i, b, u, mark,
+    // ruby, rt, rp, bdi, bdo, br, wbr
+    // STEP 14.1: use the title attribute
+    // STEP 14.2: return false. If none of the above yield a usable
+    // text string there is no accessible name
+    if (
+        matchesSelector(element,
+            "em, strong, small, s, cite, q, dfn, abbr, time, code, var, samp, kbd, sub, sup, i, b, u, mark, ruby, rt, rp, bdi, bdo, br, wbr"
+        )
+    ) {
+        if (strlen(element.textContent) > 0) {
+            return element.textContent;
+        } else if (element.hasAttribute("title")) {
+            return element.getAttribute("title");
+        } else {
+            return false;
+        }
+    }
+    // Absolute last ditch for the whole plugin:
+    // use the accessible text from the element itself.
+    if (strlen(getAccessibleText(element)) > 0) {
+        return getAccessibleText(element);
+    }
+    // If we get here, there is no accessible name
+    else {
+        return false;
+    }
+}
+/**
+ * Helper function to check if element is NOT visible
+ * @param {Element} element - The element to check
+ * @returns {boolean} True if element is not visible, false otherwise
+ */
+function isNotVisible(element) {
+    // Importing isVisible would be better, but for this standalone function we'll check it this way
+    if (!element) return true;
+    // These elements are inherently not visible
+    const nonVisibleSelectors = [
+        'base', 'head', 'meta', 'title', 'link', 'style', 'script', 'br', 'nobr', 'col', 'embed',
+        'input[type="hidden"]', 'keygen', 'source', 'track', 'wbr', 'datalist', 'area', 'param', 'noframes', 'ruby > rp'
+    ];
+    if (nonVisibleSelectors.some(selector => matchesSelector(element, selector))) {
+        return true; // Not visible in accessibility tree
+    }
+    // Check if display is none
+    const isElemDisplayed = el => window.getComputedStyle(el).display === 'none';
+    if (isElemDisplayed(element)) return true;
+    // Check parent elements
+    let parent = element.parentElement;
+    while (parent) {
+        if (isElemDisplayed(parent)) return true;
+        parent = parent.parentElement;
+    }
+    return element.getAttribute('aria-hidden') === 'true';
+}
+/**
+ * Helper function to check if an element matches a selector
+ * @param {Element} element - Element to check
+ * @param {string} selector - CSS selector to match against
+ * @returns {boolean} True if element matches the selector
+ */
+function matchesSelector(element, selector) {
+    if (!element) return false;
+    // Use the right matches function depending on browser support
+    const matchesMethod = element.matches ||
+                           element.mozMatchesSelector ||
+                           element.msMatchesSelector;
+    // Handle multiple selectors (comma-separated)
+    if (selector.includes(',')) {
+        return selector.split(',').some(s => matchesMethod.call(element, s.trim()));
+    }
+    return matchesMethod.call(element, selector);
+}
+/**
+ * Get the length of a trimmed string, or return 0 if not a valid string
+ * @param {string} str - The string to measure
+ * @returns {number} The string length or 0
+ */
+function strlen(str) {
+    return typeof str === "string" &amp;&amp; !isEmpty(str.trim()) ? str.trim().length : 0;
+}
+// Export as default for ES modules
+export default getAccessibleName;
+// Export the function for CommonJS module usage
+if (typeof module !== 'undefined' &amp;&amp; module.exports) {
+    module.exports = getAccessibleName;
+} else if (typeof window !== 'undefined') {
+    // Add to window object for browser usage
+    window.getAccessibleName = getAccessibleName;
+}</code></pre></article></section></div></div></div><div class="search-container" id="PkfLWpAbet" style="display:none"><div class="wrapper" id="iCxFxjkHbP"><button class="icon-button search-close-button" id="VjLlGakifb" aria-label="close search"><svg><use xlink:href="#close-icon"></use></svg></button><div class="search-box-c"><svg><use xlink:href="#search-icon"></use></svg> <input type="text" id="vpcKVYIppa" class="search-input" placeholder="Search..." autofocus></div><div class="search-result-c" id="fWwVHRuDuN"><span class="search-result-c-text">Type anything to view search result</span></div></div></div><div class="mobile-menu-icon-container"><button class="icon-button" id="mobile-menu" data-isopen="false" aria-label="menu"><svg><use xlink:href="#menu-icon"></use></svg></button></div><div id="mobile-sidebar" class="mobile-sidebar-container"><div class="mobile-sidebar-wrapper"><div class="mobile-nav-links"></div><div class="mobile-sidebar-items-c"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-afixt-test-utils.html">afixt-test-utils</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#arrayCount">arrayCount</a></div><div class="sidebar-section-children"><a href="global.html#arrayRemoveByValue">arrayRemoveByValue</a></div><div class="sidebar-section-children"><a href="global.html#arrayUnique">arrayUnique</a></div><div class="sidebar-section-children"><a href="global.html#cellColorDiffs">cellColorDiffs</a></div><div class="sidebar-section-children"><a href="global.html#cellCount">cellCount</a></div><div class="sidebar-section-children"><a href="global.html#checkInconsistent">checkInconsistent</a></div><div class="sidebar-section-children"><a href="global.html#checkMultiRowsInHeader">checkMultiRowsInHeader</a></div><div class="sidebar-section-children"><a href="global.html#checkMultiRowsWithColspan">checkMultiRowsWithColspan</a></div><div class="sidebar-section-children"><a href="global.html#cleanBlank">cleanBlank</a></div><div class="sidebar-section-children"><a href="global.html#colCount">colCount</a></div><div class="sidebar-section-children"><a href="global.html#countBordersPct">countBordersPct</a></div><div class="sidebar-section-children"><a href="global.html#getAccessibleName">getAccessibleName</a></div><div class="sidebar-section-children"><a href="global.html#getAccessibleText">getAccessibleText</a></div><div class="sidebar-section-children"><a href="global.html#getAriaAttributes">getAriaAttributes</a></div><div class="sidebar-section-children"><a href="global.html#getCSSGeneratedContent">getCSSGeneratedContent</a></div><div class="sidebar-section-children"><a href="global.html#getColorContrast">getColorContrast</a></div><div class="sidebar-section-children"><a href="global.html#getComputedBackgroundColor">getComputedBackgroundColor</a></div><div class="sidebar-section-children"><a href="global.html#getComputedRole">getComputedRole</a></div><div class="sidebar-section-children"><a href="global.html#getFocusableElements">getFocusableElements</a></div><div class="sidebar-section-children"><a href="global.html#getGeneratedContent">getGeneratedContent</a></div><div class="sidebar-section-children"><a href="global.html#getImageText">getImageText</a></div><div class="sidebar-section-children"><a href="global.html#getStyleObject">getStyleObject</a></div><div class="sidebar-section-children"><a href="global.html#getTwoLetterCode">getTwoLetterCode</a></div><div class="sidebar-section-children"><a href="global.html#hasAccessibleName">hasAccessibleName</a></div><div class="sidebar-section-children"><a href="global.html#hasAttribute">hasAttribute</a></div><div class="sidebar-section-children"><a href="global.html#hasCSSGeneratedContent">hasCSSGeneratedContent</a></div><div class="sidebar-section-children"><a href="global.html#hasHiddenParent">hasHiddenParent</a></div><div class="sidebar-section-children"><a href="global.html#hasParent">hasParent</a></div><div class="sidebar-section-children"><a href="global.html#hasValidAriaAttributes">hasValidAriaAttributes</a></div><div class="sidebar-section-children"><a href="global.html#hasValidAriaRole">hasValidAriaRole</a></div><div class="sidebar-section-children"><a href="global.html#isAriaAttributeValid">isAriaAttributeValid</a></div><div class="sidebar-section-children"><a href="global.html#isComplexTable">isComplexTable</a></div><div class="sidebar-section-children"><a href="global.html#isDataTable">isDataTable</a></div><div class="sidebar-section-children"><a href="global.html#isFocusable">isFocusable</a></div><div class="sidebar-section-children"><a href="global.html#isHidden">isHidden</a></div><div class="sidebar-section-children"><a href="global.html#isNotVisible">isNotVisible</a></div><div class="sidebar-section-children"><a href="global.html#isOffScreen">isOffScreen</a></div><div class="sidebar-section-children"><a href="global.html#isValidUrl">isValidUrl</a></div><div class="sidebar-section-children"><a href="global.html#isVisible">isVisible</a></div><div class="sidebar-section-children"><a href="global.html#langCodes">langCodes</a></div><div class="sidebar-section-children"><a href="global.html#luminance">luminance</a></div><div class="sidebar-section-children"><a href="global.html#matchesSelector">matchesSelector</a></div><div class="sidebar-section-children"><a href="global.html#parseRGB">parseRGB</a></div><div class="sidebar-section-children"><a href="global.html#rowCount">rowCount</a></div><div class="sidebar-section-children"><a href="global.html#rtls">rtls</a></div><div class="sidebar-section-children"><a href="global.html#sortByVisualOrder">sortByVisualOrder</a></div><div class="sidebar-section-children"><a href="global.html#strlen">strlen</a></div><div class="sidebar-section-children"><a href="global.html#testContrast">testContrast</a></div><div class="sidebar-section-children"><a href="global.html#testLang">testLang</a></div><div class="sidebar-section-children"><a href="global.html#testOrder">testOrder</a></div><div class="sidebar-section-children"><a href="global.html#validAriaAttributes">validAriaAttributes</a></div><div class="sidebar-section-children"><a href="global.html#validLangCodes">validLangCodes</a></div></div></div><div class="mobile-navbar-actions"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#light-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div></div></div><script type="text/javascript" src="scripts/core.min.js"></script><script src="scripts/search.min.js" defer="defer"></script><script src="scripts/third-party/fuse.js" defer="defer"></script><script type="text/javascript">var tocbotInstance=tocbot.init({tocSelector:"#eed4d2a0bfd64539bb9df78095dec881",contentSelector:".main-content",headingSelector:"h1, h2, h3",hasInnerContainers:!0,scrollContainer:".main-content",headingsOffset:130,onClick:bringLinkToView})</script></body></html>

package/docs/getAccessibleText.js.html ADDED Viewed

@@ -0,0 +1,65 @@
+<!DOCTYPE html><html lang="en" style="font-size:16px"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Source: getAccessibleText.js</title><!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]--><script src="scripts/third-party/hljs.js" defer="defer"></script><script src="scripts/third-party/hljs-line-num.js" defer="defer"></script><script src="scripts/third-party/popper.js" defer="defer"></script><script src="scripts/third-party/tippy.js" defer="defer"></script><script src="scripts/third-party/tocbot.min.js"></script><script>var baseURL="/",locationPathname="";baseURL=(locationPathname=document.location.pathname).substr(0,locationPathname.lastIndexOf("/")+1)</script><link rel="stylesheet" href="styles/clean-jsdoc-theme.min.css"><svg aria-hidden="true" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="display:none"><defs><symbol id="copy-icon" viewbox="0 0 488.3 488.3"><g><path d="M314.25,85.4h-227c-21.3,0-38.6,17.3-38.6,38.6v325.7c0,21.3,17.3,38.6,38.6,38.6h227c21.3,0,38.6-17.3,38.6-38.6V124    C352.75,102.7,335.45,85.4,314.25,85.4z M325.75,449.6c0,6.4-5.2,11.6-11.6,11.6h-227c-6.4,0-11.6-5.2-11.6-11.6V124    c0-6.4,5.2-11.6,11.6-11.6h227c6.4,0,11.6,5.2,11.6,11.6V449.6z"/><path d="M401.05,0h-227c-21.3,0-38.6,17.3-38.6,38.6c0,7.5,6,13.5,13.5,13.5s13.5-6,13.5-13.5c0-6.4,5.2-11.6,11.6-11.6h227    c6.4,0,11.6,5.2,11.6,11.6v325.7c0,6.4-5.2,11.6-11.6,11.6c-7.5,0-13.5,6-13.5,13.5s6,13.5,13.5,13.5c21.3,0,38.6-17.3,38.6-38.6    V38.6C439.65,17.3,422.35,0,401.05,0z"/></g></symbol><symbol id="search-icon" viewBox="0 0 512 512"><g><g><path d="M225.474,0C101.151,0,0,101.151,0,225.474c0,124.33,101.151,225.474,225.474,225.474    c124.33,0,225.474-101.144,225.474-225.474C450.948,101.151,349.804,0,225.474,0z M225.474,409.323    c-101.373,0-183.848-82.475-183.848-183.848S124.101,41.626,225.474,41.626s183.848,82.475,183.848,183.848    S326.847,409.323,225.474,409.323z"/></g></g><g><g><path d="M505.902,476.472L386.574,357.144c-8.131-8.131-21.299-8.131-29.43,0c-8.131,8.124-8.131,21.306,0,29.43l119.328,119.328    c4.065,4.065,9.387,6.098,14.715,6.098c5.321,0,10.649-2.033,14.715-6.098C514.033,497.778,514.033,484.596,505.902,476.472z"/></g></g></symbol><symbol id="font-size-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11.246 15H4.754l-2 5H.6L7 4h2l6.4 16h-2.154l-2-5zm-.8-2L8 6.885 5.554 13h4.892zM21 12.535V12h2v8h-2v-.535a4 4 0 1 1 0-6.93zM19 18a2 2 0 1 0 0-4 2 2 0 0 0 0 4z"/></symbol><symbol id="add-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11 11V5h2v6h6v2h-6v6h-2v-6H5v-2z"/></symbol><symbol id="minus-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M5 11h14v2H5z"/></symbol><symbol id="dark-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M10 7a7 7 0 0 0 12 4.9v.1c0 5.523-4.477 10-10 10S2 17.523 2 12 6.477 2 12 2h.1A6.979 6.979 0 0 0 10 7zm-6 5a8 8 0 0 0 15.062 3.762A9 9 0 0 1 8.238 4.938 7.999 7.999 0 0 0 4 12z"/></symbol><symbol id="light-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 18a6 6 0 1 1 0-12 6 6 0 0 1 0 12zm0-2a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM11 1h2v3h-2V1zm0 19h2v3h-2v-3zM3.515 4.929l1.414-1.414L7.05 5.636 5.636 7.05 3.515 4.93zM16.95 18.364l1.414-1.414 2.121 2.121-1.414 1.414-2.121-2.121zm2.121-14.85l1.414 1.415-2.121 2.121-1.414-1.414 2.121-2.121zM5.636 16.95l1.414 1.414-2.121 2.121-1.414-1.414 2.121-2.121zM23 11v2h-3v-2h3zM4 11v2H1v-2h3z"/></symbol><symbol id="reset-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M18.537 19.567A9.961 9.961 0 0 1 12 22C6.477 22 2 17.523 2 12S6.477 2 12 2s10 4.477 10 10c0 2.136-.67 4.116-1.81 5.74L17 12h3a8 8 0 1 0-2.46 5.772l.997 1.795z"/></symbol><symbol id="down-icon" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M12.7803 6.21967C13.0732 6.51256 13.0732 6.98744 12.7803 7.28033L8.53033 11.5303C8.23744 11.8232 7.76256 11.8232 7.46967 11.5303L3.21967 7.28033C2.92678 6.98744 2.92678 6.51256 3.21967 6.21967C3.51256 5.92678 3.98744 5.92678 4.28033 6.21967L8 9.93934L11.7197 6.21967C12.0126 5.92678 12.4874 5.92678 12.7803 6.21967Z"></path></symbol><symbol id="codepen-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M16.5 13.202L13 15.535v3.596L19.197 15 16.5 13.202zM14.697 12L12 10.202 9.303 12 12 13.798 14.697 12zM20 10.869L18.303 12 20 13.131V10.87zM19.197 9L13 4.869v3.596l3.5 2.333L19.197 9zM7.5 10.798L11 8.465V4.869L4.803 9 7.5 10.798zM4.803 15L11 19.131v-3.596l-3.5-2.333L4.803 15zM4 13.131L5.697 12 4 10.869v2.262zM2 9a1 1 0 0 1 .445-.832l9-6a1 1 0 0 1 1.11 0l9 6A1 1 0 0 1 22 9v6a1 1 0 0 1-.445.832l-9 6a1 1 0 0 1-1.11 0l-9-6A1 1 0 0 1 2 15V9z"/></symbol><symbol id="close-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 10.586l4.95-4.95 1.414 1.414-4.95 4.95 4.95 4.95-1.414 1.414-4.95-4.95-4.95 4.95-1.414-1.414 4.95-4.95-4.95-4.95L7.05 5.636z"/></symbol><symbol id="menu-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M3 4h18v2H3V4zm0 7h18v2H3v-2zm0 7h18v2H3v-2z"/></symbol></defs></svg></head><body data-theme="dark"><div class="sidebar-container"><div class="sidebar" id="sidebar"><div class="sidebar-items-container"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-afixt-test-utils.html">afixt-test-utils</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#arrayCount">arrayCount</a></div><div class="sidebar-section-children"><a href="global.html#arrayRemoveByValue">arrayRemoveByValue</a></div><div class="sidebar-section-children"><a href="global.html#arrayUnique">arrayUnique</a></div><div class="sidebar-section-children"><a href="global.html#cellColorDiffs">cellColorDiffs</a></div><div class="sidebar-section-children"><a href="global.html#cellCount">cellCount</a></div><div class="sidebar-section-children"><a href="global.html#checkInconsistent">checkInconsistent</a></div><div class="sidebar-section-children"><a href="global.html#checkMultiRowsInHeader">checkMultiRowsInHeader</a></div><div class="sidebar-section-children"><a href="global.html#checkMultiRowsWithColspan">checkMultiRowsWithColspan</a></div><div class="sidebar-section-children"><a href="global.html#cleanBlank">cleanBlank</a></div><div class="sidebar-section-children"><a href="global.html#colCount">colCount</a></div><div class="sidebar-section-children"><a href="global.html#countBordersPct">countBordersPct</a></div><div class="sidebar-section-children"><a href="global.html#getAccessibleName">getAccessibleName</a></div><div class="sidebar-section-children"><a href="global.html#getAccessibleText">getAccessibleText</a></div><div class="sidebar-section-children"><a href="global.html#getAriaAttributes">getAriaAttributes</a></div><div class="sidebar-section-children"><a href="global.html#getCSSGeneratedContent">getCSSGeneratedContent</a></div><div class="sidebar-section-children"><a href="global.html#getColorContrast">getColorContrast</a></div><div class="sidebar-section-children"><a href="global.html#getComputedBackgroundColor">getComputedBackgroundColor</a></div><div class="sidebar-section-children"><a href="global.html#getComputedRole">getComputedRole</a></div><div class="sidebar-section-children"><a href="global.html#getFocusableElements">getFocusableElements</a></div><div class="sidebar-section-children"><a href="global.html#getGeneratedContent">getGeneratedContent</a></div><div class="sidebar-section-children"><a href="global.html#getImageText">getImageText</a></div><div class="sidebar-section-children"><a href="global.html#getStyleObject">getStyleObject</a></div><div class="sidebar-section-children"><a href="global.html#getTwoLetterCode">getTwoLetterCode</a></div><div class="sidebar-section-children"><a href="global.html#hasAccessibleName">hasAccessibleName</a></div><div class="sidebar-section-children"><a href="global.html#hasAttribute">hasAttribute</a></div><div class="sidebar-section-children"><a href="global.html#hasCSSGeneratedContent">hasCSSGeneratedContent</a></div><div class="sidebar-section-children"><a href="global.html#hasHiddenParent">hasHiddenParent</a></div><div class="sidebar-section-children"><a href="global.html#hasParent">hasParent</a></div><div class="sidebar-section-children"><a href="global.html#hasValidAriaAttributes">hasValidAriaAttributes</a></div><div class="sidebar-section-children"><a href="global.html#hasValidAriaRole">hasValidAriaRole</a></div><div class="sidebar-section-children"><a href="global.html#isAriaAttributeValid">isAriaAttributeValid</a></div><div class="sidebar-section-children"><a href="global.html#isComplexTable">isComplexTable</a></div><div class="sidebar-section-children"><a href="global.html#isDataTable">isDataTable</a></div><div class="sidebar-section-children"><a href="global.html#isFocusable">isFocusable</a></div><div class="sidebar-section-children"><a href="global.html#isHidden">isHidden</a></div><div class="sidebar-section-children"><a href="global.html#isNotVisible">isNotVisible</a></div><div class="sidebar-section-children"><a href="global.html#isOffScreen">isOffScreen</a></div><div class="sidebar-section-children"><a href="global.html#isValidUrl">isValidUrl</a></div><div class="sidebar-section-children"><a href="global.html#isVisible">isVisible</a></div><div class="sidebar-section-children"><a href="global.html#langCodes">langCodes</a></div><div class="sidebar-section-children"><a href="global.html#luminance">luminance</a></div><div class="sidebar-section-children"><a href="global.html#matchesSelector">matchesSelector</a></div><div class="sidebar-section-children"><a href="global.html#parseRGB">parseRGB</a></div><div class="sidebar-section-children"><a href="global.html#rowCount">rowCount</a></div><div class="sidebar-section-children"><a href="global.html#rtls">rtls</a></div><div class="sidebar-section-children"><a href="global.html#sortByVisualOrder">sortByVisualOrder</a></div><div class="sidebar-section-children"><a href="global.html#strlen">strlen</a></div><div class="sidebar-section-children"><a href="global.html#testContrast">testContrast</a></div><div class="sidebar-section-children"><a href="global.html#testLang">testLang</a></div><div class="sidebar-section-children"><a href="global.html#testOrder">testOrder</a></div><div class="sidebar-section-children"><a href="global.html#validAriaAttributes">validAriaAttributes</a></div><div class="sidebar-section-children"><a href="global.html#validLangCodes">validLangCodes</a></div></div></div></div></div><div class="navbar-container" id="VuAckcnZhf"><nav class="navbar"><div class="navbar-left-items"></div><div class="navbar-right-items"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#light-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div><nav></nav></nav></div><div class="toc-container"><div class="toc-content"><span class="bold">On this page</span><div id="eed4d2a0bfd64539bb9df78095dec881"></div></div></div><div class="body-wrapper"><div class="main-content"><div class="main-wrapper"><section id="source-page" class="source-page"><header><h1 id="title" class="has-anchor">getAccessibleText.js</h1></header><article><pre class="prettyprint source lang-js"><code>import { isEmpty } from "./stringUtils.js";
+/**
+ * Get all accessible text for an element, including aria-labels and content from children.
+ * @param {Element} el - The DOM element.
+ * @returns {string} The accessible text.
+ */
+export function getAccessibleText(el) {
+    if (!el) return "";
+    let textContent = "";
+    // Check for element's own text content
+    if (el.textContent) {
+        textContent = el.textContent.trim();
+    }
+    // Check for aria-label
+    if (el.hasAttribute("aria-label")) {
+        const ariaLabel = el.getAttribute("aria-label").trim();
+        if (ariaLabel) {
+            // Prioritize aria-label if present
+            return ariaLabel;
+        }
+    }
+    // Check for img alt text
+    if (el.tagName.toLowerCase() === "img" &amp;&amp; el.hasAttribute("alt")) {
+        return el.getAttribute("alt").trim();
+    }
+    // Handle other elements by getting visible text
+    if (!textContent) {
+        const walker = document.createTreeWalker(
+            el,
+            NodeFilter.SHOW_TEXT,
+            {
+                acceptNode: function (node) {
+                    // Only accept non-empty text nodes
+                    return node.nodeType === Node.TEXT_NODE &amp;&amp; !isEmpty(node.nodeValue)
+                        ? NodeFilter.FILTER_ACCEPT
+                        : NodeFilter.FILTER_REJECT;
+                },
+            }
+        );
+        let textNodes = [];
+        let node;
+        while ((node = walker.nextNode())) {
+            textNodes.push(node.nodeValue.trim());
+        }
+        textContent = textNodes.join(" ").trim();
+    }
+    return textContent;
+}
+// Export for CommonJS module usage
+if (typeof module !== 'undefined' &amp;&amp; module.exports) {
+    module.exports = { getAccessibleText };
+}</code></pre></article></section></div></div></div><div class="search-container" id="PkfLWpAbet" style="display:none"><div class="wrapper" id="iCxFxjkHbP"><button class="icon-button search-close-button" id="VjLlGakifb" aria-label="close search"><svg><use xlink:href="#close-icon"></use></svg></button><div class="search-box-c"><svg><use xlink:href="#search-icon"></use></svg> <input type="text" id="vpcKVYIppa" class="search-input" placeholder="Search..." autofocus></div><div class="search-result-c" id="fWwVHRuDuN"><span class="search-result-c-text">Type anything to view search result</span></div></div></div><div class="mobile-menu-icon-container"><button class="icon-button" id="mobile-menu" data-isopen="false" aria-label="menu"><svg><use xlink:href="#menu-icon"></use></svg></button></div><div id="mobile-sidebar" class="mobile-sidebar-container"><div class="mobile-sidebar-wrapper"><div class="mobile-nav-links"></div><div class="mobile-sidebar-items-c"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-afixt-test-utils.html">afixt-test-utils</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#arrayCount">arrayCount</a></div><div class="sidebar-section-children"><a href="global.html#arrayRemoveByValue">arrayRemoveByValue</a></div><div class="sidebar-section-children"><a href="global.html#arrayUnique">arrayUnique</a></div><div class="sidebar-section-children"><a href="global.html#cellColorDiffs">cellColorDiffs</a></div><div class="sidebar-section-children"><a href="global.html#cellCount">cellCount</a></div><div class="sidebar-section-children"><a href="global.html#checkInconsistent">checkInconsistent</a></div><div class="sidebar-section-children"><a href="global.html#checkMultiRowsInHeader">checkMultiRowsInHeader</a></div><div class="sidebar-section-children"><a href="global.html#checkMultiRowsWithColspan">checkMultiRowsWithColspan</a></div><div class="sidebar-section-children"><a href="global.html#cleanBlank">cleanBlank</a></div><div class="sidebar-section-children"><a href="global.html#colCount">colCount</a></div><div class="sidebar-section-children"><a href="global.html#countBordersPct">countBordersPct</a></div><div class="sidebar-section-children"><a href="global.html#getAccessibleName">getAccessibleName</a></div><div class="sidebar-section-children"><a href="global.html#getAccessibleText">getAccessibleText</a></div><div class="sidebar-section-children"><a href="global.html#getAriaAttributes">getAriaAttributes</a></div><div class="sidebar-section-children"><a href="global.html#getCSSGeneratedContent">getCSSGeneratedContent</a></div><div class="sidebar-section-children"><a href="global.html#getColorContrast">getColorContrast</a></div><div class="sidebar-section-children"><a href="global.html#getComputedBackgroundColor">getComputedBackgroundColor</a></div><div class="sidebar-section-children"><a href="global.html#getComputedRole">getComputedRole</a></div><div class="sidebar-section-children"><a href="global.html#getFocusableElements">getFocusableElements</a></div><div class="sidebar-section-children"><a href="global.html#getGeneratedContent">getGeneratedContent</a></div><div class="sidebar-section-children"><a href="global.html#getImageText">getImageText</a></div><div class="sidebar-section-children"><a href="global.html#getStyleObject">getStyleObject</a></div><div class="sidebar-section-children"><a href="global.html#getTwoLetterCode">getTwoLetterCode</a></div><div class="sidebar-section-children"><a href="global.html#hasAccessibleName">hasAccessibleName</a></div><div class="sidebar-section-children"><a href="global.html#hasAttribute">hasAttribute</a></div><div class="sidebar-section-children"><a href="global.html#hasCSSGeneratedContent">hasCSSGeneratedContent</a></div><div class="sidebar-section-children"><a href="global.html#hasHiddenParent">hasHiddenParent</a></div><div class="sidebar-section-children"><a href="global.html#hasParent">hasParent</a></div><div class="sidebar-section-children"><a href="global.html#hasValidAriaAttributes">hasValidAriaAttributes</a></div><div class="sidebar-section-children"><a href="global.html#hasValidAriaRole">hasValidAriaRole</a></div><div class="sidebar-section-children"><a href="global.html#isAriaAttributeValid">isAriaAttributeValid</a></div><div class="sidebar-section-children"><a href="global.html#isComplexTable">isComplexTable</a></div><div class="sidebar-section-children"><a href="global.html#isDataTable">isDataTable</a></div><div class="sidebar-section-children"><a href="global.html#isFocusable">isFocusable</a></div><div class="sidebar-section-children"><a href="global.html#isHidden">isHidden</a></div><div class="sidebar-section-children"><a href="global.html#isNotVisible">isNotVisible</a></div><div class="sidebar-section-children"><a href="global.html#isOffScreen">isOffScreen</a></div><div class="sidebar-section-children"><a href="global.html#isValidUrl">isValidUrl</a></div><div class="sidebar-section-children"><a href="global.html#isVisible">isVisible</a></div><div class="sidebar-section-children"><a href="global.html#langCodes">langCodes</a></div><div class="sidebar-section-children"><a href="global.html#luminance">luminance</a></div><div class="sidebar-section-children"><a href="global.html#matchesSelector">matchesSelector</a></div><div class="sidebar-section-children"><a href="global.html#parseRGB">parseRGB</a></div><div class="sidebar-section-children"><a href="global.html#rowCount">rowCount</a></div><div class="sidebar-section-children"><a href="global.html#rtls">rtls</a></div><div class="sidebar-section-children"><a href="global.html#sortByVisualOrder">sortByVisualOrder</a></div><div class="sidebar-section-children"><a href="global.html#strlen">strlen</a></div><div class="sidebar-section-children"><a href="global.html#testContrast">testContrast</a></div><div class="sidebar-section-children"><a href="global.html#testLang">testLang</a></div><div class="sidebar-section-children"><a href="global.html#testOrder">testOrder</a></div><div class="sidebar-section-children"><a href="global.html#validAriaAttributes">validAriaAttributes</a></div><div class="sidebar-section-children"><a href="global.html#validLangCodes">validLangCodes</a></div></div></div><div class="mobile-navbar-actions"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#light-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div></div></div><script type="text/javascript" src="scripts/core.min.js"></script><script src="scripts/search.min.js" defer="defer"></script><script src="scripts/third-party/fuse.js" defer="defer"></script><script type="text/javascript">var tocbotInstance=tocbot.init({tocSelector:"#eed4d2a0bfd64539bb9df78095dec881",contentSelector:".main-content",headingSelector:"h1, h2, h3",hasInnerContainers:!0,scrollContainer:".main-content",headingsOffset:130,onClick:bringLinkToView})</script></body></html>