axe-core 4.10.1 → 4.10.2-canary.71cbd90

package/README.md

@@ -14,7 +14,7 @@ Axe is an accessibility testing engine for websites and other HTML-based user in
 
 ## The Accessibility Rules
 
-Axe-core has different types of rules, for WCAG 2.0, 2.1, 2.2 on level A, AA and AAA as well as a number of best practices that help you identify common accessibility practices like ensuring every page has an `h1` heading, and to help you avoid "gotchas" in ARIA like where an ARIA attribute you used will get ignored. The complete list of rules, grouped WCAG level and best practice, can found in [doc/rule-descriptions.md](./doc/rule-descriptions.md).
+Axe-core has different types of rules, for WCAG 2.0, 2.1, 2.2 on level A, AA and AAA as well as a number of best practices that help you identify common accessibility practices like ensuring every page has an `h1` heading, and to help you avoid "gotchas" in ARIA like where an ARIA attribute you used will get ignored. The complete list of rules, grouped WCAG level and best practice, can be found in [doc/rule-descriptions.md](./doc/rule-descriptions.md).
 
 With axe-core, you can find **on average 57% of WCAG issues automatically**. Additionally, axe-core will return elements as "incomplete" where axe-core could not be certain, and manual review is needed.
 
@@ -65,7 +65,7 @@ Axe was built to reflect how web development actually works. It works with all m
 - It's actively supported by [Deque Systems](https://www.deque.com), a major accessibility vendor.
 - It integrates with your existing functional/acceptance automated tests.
 - It automatically determines which rules to run based on the evaluation context.
-- Axe supports in-memory fixtures, static fixtures, integration tests and iframes of infinite depth.
+- Axe supports in-memory fixtures, static fixtures, integration tests, and iframes of infinite depth.
 - Axe is highly configurable.
 
 ## Supported Browsers

package/axe.d.ts

@@ -342,6 +342,9 @@ declare namespace axe {
   interface DqElement extends SerialDqElement {
     element: Element;
     toJSON(): SerialDqElement;
+  }
+  interface DqElementConstructor {
+    new (elm: Element, options?: { absolutePaths?: boolean }): DqElement;
     mergeSpecs(
       childSpec: SerialDqElement,
       parentSpec: SerialDqElement
@@ -405,6 +408,24 @@ declare namespace axe {
     boundingClientRect: DOMRect;
   }
 
+  interface CustomNodeSerializer<T = SerialDqElement> {
+    toSpec: (dqElm: DqElement) => T;
+    mergeSpecs: (nodeSpec: T, parentFrameSpec: T) => T;
+  }
+
+  interface NodeSerializer {
+    update: <T>(serializer: CustomNodeSerializer<T>) => void;
+    toSpec: (node: Element | VirtualNode) => SerialDqElement;
+    dqElmToSpec: (
+      dqElm: DqElement | SerialDqElement,
+      options?: RunOptions
+    ) => SerialDqElement;
+    mergeSpecs: (
+      nodeSpec: SerialDqElement,
+      parentFrameSpec: SerialDqElement
+    ) => SerialDqElement;
+  }
+
   interface Utils {
     getFrameContexts: (
       context?: ElementContext,
@@ -423,15 +444,13 @@ declare namespace axe {
       selector: unknown
     ) => selector is LabelledShadowDomSelector;
 
-    DqElement: new (
-      elm: Element,
-      options?: { absolutePaths?: boolean }
-    ) => DqElement;
+    DqElement: DqElementConstructor;
     uuid: (
       options?: { random?: Uint8Array | Array<number> },
       buf?: Uint8Array | Array<number>,
       offset?: number
     ) => string | Uint8Array | Array<number>;
+    nodeSerializer: NodeSerializer;
   }
 
   interface Aria {

package/axe.js

@@ -1,4 +1,4 @@
-/*! axe v4.10.1
+/*! axe v4.10.2-canary.71cbd90
  * Copyright (c) 2015 - 2024 Deque Systems, Inc.
  *
  * Your use of this Source Code Form is subject to the terms of the Mozilla Public
@@ -22,7 +22,7 @@
     }, _typeof(o);
   }
   var axe = axe || {};
-  axe.version = '4.10.1';
+  axe.version = '4.10.2-canary.71cbd90';
   if (typeof define === 'function' && define.amd) {
     define('axe-core', [], function() {
       return axe;
@@ -6943,6 +6943,9 @@
       parseStylesheet: function parseStylesheet() {
         return parse_stylesheet_default;
       },
+      parseTabindex: function parseTabindex() {
+        return parse_tabindex_default;
+      },
       performanceTimer: function performanceTimer() {
         return performance_timer_default;
       },
@@ -7625,7 +7628,7 @@
       var parentElement = node.parentElement;
       var parentNode = node.parentNode;
       var nthChild = '';
-      if (nodeName2 !== 'head' && nodeName2 !== 'body' && parentNode.children.length > 1) {
+      if (nodeName2 !== 'head' && nodeName2 !== 'body' && (parentNode === null || parentNode === void 0 ? void 0 : parentNode.children.length) > 1) {
         var index = Array.prototype.indexOf.call(parentNode.children, node) + 1;
         nthChild = ':nth-child('.concat(index, ')');
       }
@@ -10299,9 +10302,8 @@
       var nodeAndDescendents = query_selector_all_default(virtualNode, '*');
       var tabbableElements = nodeAndDescendents.filter(function(vNode) {
         var isFocusable2 = vNode.isFocusable;
-        var tabIndex = vNode.actualNode.getAttribute('tabindex');
-        tabIndex = tabIndex && !isNaN(parseInt(tabIndex, 10)) ? parseInt(tabIndex) : null;
-        return tabIndex ? isFocusable2 && tabIndex >= 0 : isFocusable2;
+        var tabIndex = parse_tabindex_default(vNode.actualNode.getAttribute('tabindex'));
+        return tabIndex !== null ? isFocusable2 && tabIndex >= 0 : isFocusable2;
       });
       return tabbableElements;
     }
@@ -10344,18 +10346,15 @@
       } else if (is_natively_focusable_default(vNode)) {
         return true;
       }
-      var tabindex = vNode.attr('tabindex');
-      if (tabindex && !isNaN(parseInt(tabindex, 10))) {
-        return true;
-      }
-      return false;
+      var tabindex = parse_tabindex_default(vNode.attr('tabindex'));
+      return tabindex !== null;
     }
     function _isInTabOrder(el) {
       var _nodeLookup6 = _nodeLookup(el), vNode = _nodeLookup6.vNode;
       if (vNode.props.nodeType !== 1) {
         return false;
       }
-      var tabindex = parseInt(vNode.attr('tabindex', 10));
+      var tabindex = parse_tabindex_default(vNode.attr('tabindex'));
       if (tabindex <= -1) {
         return false;
       }
@@ -13893,7 +13892,7 @@
       });
     }
     function insertedIntoFocusOrder(el) {
-      var tabIndex = parseInt(el.getAttribute('tabindex'), 10);
+      var tabIndex = parse_tabindex_default(el.getAttribute('tabindex'));
       return tabIndex > -1 && _isFocusable(el) && !is_natively_focusable_default(el);
     }
     var inserted_into_focus_order_default = insertedIntoFocusOrder;
@@ -18616,12 +18615,8 @@
       };
     }
     function frameFocusable(frame) {
-      var tabIndex = frame.getAttribute('tabindex');
-      if (!tabIndex) {
-        return true;
-      }
-      var _int = parseInt(tabIndex, 10);
-      return isNaN(_int) || _int >= 0;
+      var tabIndex = parse_tabindex_default(frame.getAttribute('tabindex'));
+      return tabIndex === null || tabIndex >= 0;
     }
     function getBoundingSize(domNode) {
       var width = parseInt(domNode.getAttribute('width'), 10);
@@ -19196,6 +19191,17 @@
       });
     }
     var parse_crossorigin_stylesheet_default = parseCrossOriginStylesheet;
+    function parseTabindex(value) {
+      if (typeof value !== 'string') {
+        return null;
+      }
+      var match = value.trim().match(/^([-+]?\d+)/);
+      if (match) {
+        return Number(match[1]);
+      }
+      return null;
+    }
+    var parse_tabindex_default = parseTabindex;
     var performanceTimer = function() {
       function now() {
         if (window.performance && window.performance) {
@@ -20505,54 +20511,6 @@
       return out ? true : void 0;
     }
     var th_has_data_cells_evaluate_default = thHasDataCellsEvaluate;
-    function tdHeadersAttrEvaluate(node) {
-      var cells = [];
-      var reviewCells = [];
-      var badCells = [];
-      for (var rowIndex = 0; rowIndex < node.rows.length; rowIndex++) {
-        var row = node.rows[rowIndex];
-        for (var cellIndex = 0; cellIndex < row.cells.length; cellIndex++) {
-          cells.push(row.cells[cellIndex]);
-        }
-      }
-      var ids = cells.filter(function(cell) {
-        return cell.getAttribute('id');
-      }).map(function(cell) {
-        return cell.getAttribute('id');
-      });
-      cells.forEach(function(cell) {
-        var isSelf = false;
-        var notOfTable = false;
-        if (!cell.hasAttribute('headers') || !_isVisibleToScreenReaders(cell)) {
-          return;
-        }
-        var headersAttr = cell.getAttribute('headers').trim();
-        if (!headersAttr) {
-          return reviewCells.push(cell);
-        }
-        var headers = token_list_default(headersAttr);
-        if (headers.length !== 0) {
-          if (cell.getAttribute('id')) {
-            isSelf = headers.indexOf(cell.getAttribute('id').trim()) !== -1;
-          }
-          notOfTable = headers.some(function(header) {
-            return !ids.includes(header);
-          });
-          if (isSelf || notOfTable) {
-            badCells.push(cell);
-          }
-        }
-      });
-      if (badCells.length > 0) {
-        this.relatedNodes(badCells);
-        return false;
-      }
-      if (reviewCells.length) {
-        this.relatedNodes(reviewCells);
-        return void 0;
-      }
-      return true;
-    }
     var aria_exports = {};
     __export(aria_exports, {
       allowedAttr: function allowedAttr() {
@@ -22774,6 +22732,66 @@
       return !!attrDefinition;
     }
     var validate_attr_default = validateAttr;
+    var messageKeys = [ 'cell-header-not-in-table', 'cell-header-not-th', 'header-refs-self', 'empty-hdrs' ];
+    var notInTable = messageKeys[0], notTh = messageKeys[1], selfRef = messageKeys[2], emptyHdrs = messageKeys[3];
+    function tdHeadersAttrEvaluate(node) {
+      var cells = [];
+      var cellRoleById = {};
+      for (var rowIndex = 0; rowIndex < node.rows.length; rowIndex++) {
+        var row = node.rows[rowIndex];
+        for (var cellIndex = 0; cellIndex < row.cells.length; cellIndex++) {
+          var cell = row.cells[cellIndex];
+          cells.push(cell);
+          var cellId = cell.getAttribute('id');
+          if (cellId) {
+            cellRoleById[cellId] = get_role_default(cell);
+          }
+        }
+      }
+      var badCells = _defineProperty(_defineProperty(_defineProperty(_defineProperty({}, selfRef, new Set()), notInTable, new Set()), notTh, new Set()), emptyHdrs, new Set());
+      cells.forEach(function(cell) {
+        if (!cell.hasAttribute('headers') || !_isVisibleToScreenReaders(cell)) {
+          return;
+        }
+        var headersAttr = cell.getAttribute('headers').trim();
+        if (!headersAttr) {
+          badCells[emptyHdrs].add(cell);
+          return;
+        }
+        var cellId = cell.getAttribute('id');
+        var headers = token_list_default(headersAttr);
+        headers.forEach(function(headerId) {
+          if (cellId && headerId === cellId) {
+            badCells[selfRef].add(cell);
+          } else if (!cellRoleById[headerId]) {
+            badCells[notInTable].add(cell);
+          } else if (![ 'columnheader', 'rowheader' ].includes(cellRoleById[headerId])) {
+            badCells[notTh].add(cell);
+          }
+        });
+      });
+      var _iterator15 = _createForOfIteratorHelper(messageKeys), _step15;
+      try {
+        for (_iterator15.s(); !(_step15 = _iterator15.n()).done; ) {
+          var messageKey = _step15.value;
+          if (badCells[messageKey].size > 0) {
+            this.relatedNodes(_toConsumableArray(badCells[messageKey]));
+            if (messageKey === emptyHdrs) {
+              return void 0;
+            }
+            this.data({
+              messageKey: messageKey
+            });
+            return false;
+          }
+        }
+      } catch (err) {
+        _iterator15.e(err);
+      } finally {
+        _iterator15.f();
+      }
+      return true;
+    }
     function tdHasHeaderEvaluate(node) {
       var badCells = [];
       var cells = get_all_cells_default(node);
@@ -23162,19 +23180,19 @@
           return;
         }
         var frameAncestry = r.node.ancestry.slice(0, -1);
-        var _iterator15 = _createForOfIteratorHelper(iframeResults), _step15;
+        var _iterator16 = _createForOfIteratorHelper(iframeResults), _step16;
         try {
-          for (_iterator15.s(); !(_step15 = _iterator15.n()).done; ) {
-            var iframeResult = _step15.value;
+          for (_iterator16.s(); !(_step16 = _iterator16.n()).done; ) {
+            var iframeResult = _step16.value;
             if (_matchAncestry(frameAncestry, iframeResult.node.ancestry)) {
               r.result = iframeResult.result;
               break;
             }
           }
         } catch (err) {
-          _iterator15.e(err);
+          _iterator16.e(err);
         } finally {
-          _iterator15.f();
+          _iterator16.f();
         }
       });
       iframeResults.forEach(function(r) {
@@ -23661,11 +23679,11 @@
     }
     function getShadowColorsMap(parsedShadows) {
       var colorMap = {};
-      var _iterator16 = _createForOfIteratorHelper(parsedShadows), _step16;
+      var _iterator17 = _createForOfIteratorHelper(parsedShadows), _step17;
       try {
-        for (_iterator16.s(); !(_step16 = _iterator16.n()).done; ) {
+        for (_iterator17.s(); !(_step17 = _iterator17.n()).done; ) {
           var _colorMap$colorStr;
-          var _step16$value = _step16.value, colorStr = _step16$value.colorStr, pixels = _step16$value.pixels;
+          var _step17$value = _step17.value, colorStr = _step17$value.colorStr, pixels = _step17$value.pixels;
           (_colorMap$colorStr = colorMap[colorStr]) !== null && _colorMap$colorStr !== void 0 ? _colorMap$colorStr : colorMap[colorStr] = {
             top: [],
             right: [],
@@ -23686,9 +23704,9 @@
           }
         }
       } catch (err) {
-        _iterator16.e(err);
+        _iterator17.e(err);
       } finally {
-        _iterator16.f();
+        _iterator17.f();
       }
       return colorMap;
     }
@@ -23765,10 +23783,10 @@
       assert_default(isNaN(fontSize) === false, 'Unable to determine font-size value '.concat(fontSizeStr));
       var thinShadows = [];
       var shadows = _parseTextShadows(textShadow);
-      var _iterator17 = _createForOfIteratorHelper(shadows), _step17;
+      var _iterator18 = _createForOfIteratorHelper(shadows), _step18;
       try {
-        for (_iterator17.s(); !(_step17 = _iterator17.n()).done; ) {
-          var shadow = _step17.value;
+        for (_iterator18.s(); !(_step18 = _iterator18.n()).done; ) {
+          var shadow = _step18.value;
           var colorStr = shadow.colorStr || style.getPropertyValue('color');
           var _shadow$pixels = _slicedToArray(shadow.pixels, 3), offsetX = _shadow$pixels[0], offsetY = _shadow$pixels[1], _shadow$pixels$ = _shadow$pixels[2], blurRadius = _shadow$pixels$ === void 0 ? 0 : _shadow$pixels$;
           if (maxRatio && blurRadius >= fontSize * maxRatio) {
@@ -23801,9 +23819,9 @@
           shadowColors.push(_color3);
         }
       } catch (err) {
-        _iterator17.e(err);
+        _iterator18.e(err);
       } finally {
-        _iterator17.f();
+        _iterator18.f();
       }
       if (thinShadows.length > 0) {
         var strokeColors = _getStrokeColorsFromShadows(thinShadows, {
@@ -24131,11 +24149,11 @@
       return fgColor;
     }
     function findNodeInContexts(contexts, node) {
-      var _iterator18 = _createForOfIteratorHelper(contexts), _step18;
+      var _iterator19 = _createForOfIteratorHelper(contexts), _step19;
       try {
-        for (_iterator18.s(); !(_step18 = _iterator18.n()).done; ) {
+        for (_iterator19.s(); !(_step19 = _iterator19.n()).done; ) {
           var _context$vNode;
-          var context = _step18.value;
+          var context = _step19.value;
           if (((_context$vNode = context.vNode) === null || _context$vNode === void 0 ? void 0 : _context$vNode.actualNode) === node) {
             return context;
           }
@@ -24145,9 +24163,9 @@
           }
         }
       } catch (err) {
-        _iterator18.e(err);
+        _iterator19.e(err);
       } finally {
-        _iterator18.f();
+        _iterator19.f();
       }
     }
     function hasValidContrastRatio(bg, fg, fontSize, isBold) {
@@ -24491,10 +24509,10 @@
     function filterByElmsOverlap(vNode, nearbyElms) {
       var fullyObscuringElms = [];
       var partialObscuringElms = [];
-      var _iterator19 = _createForOfIteratorHelper(nearbyElms), _step19;
+      var _iterator20 = _createForOfIteratorHelper(nearbyElms), _step20;
       try {
-        for (_iterator19.s(); !(_step19 = _iterator19.n()).done; ) {
-          var vNeighbor = _step19.value;
+        for (_iterator20.s(); !(_step20 = _iterator20.n()).done; ) {
+          var vNeighbor = _step20.value;
           if (!isDescendantNotInTabOrder2(vNode, vNeighbor) && _hasVisualOverlap(vNode, vNeighbor) && getCssPointerEvents(vNeighbor) !== 'none') {
             if (isEnclosedRect2(vNode, vNeighbor)) {
               fullyObscuringElms.push(vNeighbor);
@@ -24504,9 +24522,9 @@
           }
         }
       } catch (err) {
-        _iterator19.e(err);
+        _iterator20.e(err);
       } finally {
-        _iterator19.f();
+        _iterator20.f();
       }
       return {
         fullyObscuringElms: fullyObscuringElms,
@@ -24579,10 +24597,10 @@
       }
       var closeNeighbors = [];
       var closestOffset = minOffset;
-      var _iterator20 = _createForOfIteratorHelper(_findNearbyElms(vNode, minOffset)), _step20;
+      var _iterator21 = _createForOfIteratorHelper(_findNearbyElms(vNode, minOffset)), _step21;
       try {
-        for (_iterator20.s(); !(_step20 = _iterator20.n()).done; ) {
-          var vNeighbor = _step20.value;
+        for (_iterator21.s(); !(_step21 = _iterator21.n()).done; ) {
+          var vNeighbor = _step21.value;
           if (get_role_type_default(vNeighbor) !== 'widget' || !_isFocusable(vNeighbor)) {
             continue;
           }
@@ -24611,9 +24629,9 @@
           closeNeighbors.push(vNeighbor);
         }
       } catch (err) {
-        _iterator20.e(err);
+        _iterator21.e(err);
       } finally {
-        _iterator20.f();
+        _iterator21.f();
       }
       if (closeNeighbors.length === 0) {
         this.data({
@@ -25422,8 +25440,8 @@
     }
     var alt_space_value_evaluate_default = altSpaceValueEvaluate;
     function tabindexEvaluate(node, options, virtualNode) {
-      var tabIndex = parseInt(virtualNode.attr('tabindex'), 10);
-      return isNaN(tabIndex) ? true : tabIndex <= 0;
+      var tabIndex = parse_tabindex_default(virtualNode.attr('tabindex'));
+      return tabIndex === null || tabIndex <= 0;
     }
     var tabindex_evaluate_default = tabindexEvaluate;
     function noFocusableContentEvaluate(node, options, virtualNode) {
@@ -25467,8 +25485,8 @@
       return retVal;
     }
     function usesUnreliableHidingStrategy(vNode) {
-      var tabIndex = parseInt(vNode.attr('tabindex'), 10);
-      return !isNaN(tabIndex) && tabIndex < 0;
+      var tabIndex = parse_tabindex_default(vNode.attr('tabindex'));
+      return tabIndex !== null && tabIndex < 0;
     }
     function landmarkIsTopLevelEvaluate(node) {
       var landmarks = get_aria_roles_by_type_default('landmark');
@@ -25540,9 +25558,7 @@
     }
     var focusable_not_tabbable_evaluate_default = focusableNotTabbableEvaluate;
     function focusableNoNameEvaluate(node, options, virtualNode) {
-      var tabIndex = virtualNode.attr('tabindex');
-      var inFocusOrder = _isFocusable(virtualNode) && tabIndex > -1;
-      if (!inFocusOrder) {
+      if (!_isInTabOrder(virtualNode)) {
         return false;
       }
       try {
@@ -26817,18 +26833,18 @@
       if (Array.isArray(options[role])) {
         allowed = unique_array_default(options[role].concat(allowed));
       }
-      var _iterator21 = _createForOfIteratorHelper(virtualNode.attrNames), _step21;
+      var _iterator22 = _createForOfIteratorHelper(virtualNode.attrNames), _step22;
       try {
-        for (_iterator21.s(); !(_step21 = _iterator21.n()).done; ) {
-          var attrName = _step21.value;
+        for (_iterator22.s(); !(_step22 = _iterator22.n()).done; ) {
+          var attrName = _step22.value;
           if (validate_attr_default(attrName) && !allowed.includes(attrName) && !ignoredAttrs(attrName, virtualNode.attr(attrName), virtualNode)) {
             invalid.push(attrName);
           }
         }
       } catch (err) {
-        _iterator21.e(err);
+        _iterator22.e(err);
       } finally {
-        _iterator21.f();
+        _iterator22.f();
       }
       if (!invalid.length) {
         return true;
@@ -27007,8 +27023,8 @@
     }
     var no_role_matches_default = noRoleMatches;
     function noNegativeTabindexMatches(node, virtualNode) {
-      var tabindex = parseInt(virtualNode.attr('tabindex'), 10);
-      return isNaN(tabindex) || tabindex >= 0;
+      var tabindex = parse_tabindex_default(virtualNode.attr('tabindex'));
+      return tabindex === null || tabindex >= 0;
     }
     var no_negative_tabindex_matches_default = noNegativeTabindexMatches;
     function noNamingMethodMatches(node, virtualNode) {
@@ -27338,14 +27354,14 @@
         return false;
       }
       var role = virtualNode.attr('role');
-      var tabIndex = virtualNode.attr('tabindex');
-      if (tabIndex === '-1' && role) {
+      var tabIndex = parse_tabindex_default(virtualNode.attr('tabindex'));
+      if (tabIndex < 0 && role) {
         var roleDef = standards_default.ariaRoles[role];
         if (roleDef === void 0 || roleDef.type !== 'widget') {
           return false;
         }
       }
-      if (tabIndex === '-1' && virtualNode.actualNode && !_isVisibleOnScreen(virtualNode) && !_isVisibleToScreenReaders(virtualNode)) {
+      if (tabIndex < 0 && virtualNode.actualNode && !_isVisibleOnScreen(virtualNode) && !_isVisibleToScreenReaders(virtualNode)) {
         return false;
       }
       return true;
@@ -27836,16 +27852,18 @@
           });
         });
       });
-      q.defer(function(res) {
-        return setTimeout(res, 0);
-      });
-      if (options.performanceTimer) {
-        this._logRulePerformance();
-      }
       q.then(function() {
-        return resolve(ruleResult);
+        if (options.performanceTimer) {
+          _this9._logRulePerformance();
+        }
+        setTimeout(function() {
+          resolve(ruleResult);
+        }, 0);
       })['catch'](function(error) {
-        return reject(error);
+        if (options.performanceTimer) {
+          _this9._logRulePerformance();
+        }
+        reject(error);
       });
     };
     Rule.prototype.runSync = function runSync2(context) {
@@ -28188,10 +28206,10 @@
         value: function setAllowedOrigins(allowedOrigins) {
           var defaultOrigin = getDefaultOrigin();
           this.allowedOrigins = [];
-          var _iterator22 = _createForOfIteratorHelper(allowedOrigins), _step22;
+          var _iterator23 = _createForOfIteratorHelper(allowedOrigins), _step23;
           try {
-            for (_iterator22.s(); !(_step22 = _iterator22.n()).done; ) {
-              var origin = _step22.value;
+            for (_iterator23.s(); !(_step23 = _iterator23.n()).done; ) {
+              var origin = _step23.value;
               if (origin === constants_default.allOrigins) {
                 this.allowedOrigins = [ '*' ];
                 return;
@@ -28202,9 +28220,9 @@
               }
             }
           } catch (err) {
-            _iterator22.e(err);
+            _iterator23.e(err);
           } finally {
-            _iterator22.f();
+            _iterator23.f();
           }
         }
       }, {
@@ -28994,10 +29012,10 @@
     }
     function setFrameSpec(partialResults) {
       var frameStack = [];
-      var _iterator23 = _createForOfIteratorHelper(partialResults), _step23;
+      var _iterator24 = _createForOfIteratorHelper(partialResults), _step24;
       try {
-        for (_iterator23.s(); !(_step23 = _iterator23.n()).done; ) {
-          var partialResult = _step23.value;
+        for (_iterator24.s(); !(_step24 = _iterator24.n()).done; ) {
+          var partialResult = _step24.value;
           var frameSpec = frameStack.shift();
           if (!partialResult) {
             continue;
@@ -29007,9 +29025,9 @@
           frameStack.unshift.apply(frameStack, _toConsumableArray(frameSpecs));
         }
       } catch (err) {
-        _iterator23.e(err);
+        _iterator24.e(err);
       } finally {
-        _iterator23.f();
+        _iterator24.f();
       }
     }
     function getMergedFrameSpecs(_ref149) {
@@ -29614,8 +29632,8 @@
           help: 'Non-empty <td> elements in larger <table> must have an associated table header'
         },
         'td-headers-attr': {
-          description: 'Ensure that each cell in a table that uses the headers attribute refers only to other cells in that table',
-          help: 'Table cells that use the headers attribute must only refer to cells in the same table'
+          description: 'Ensure that each cell in a table that uses the headers attribute refers only to other <th> elements in that table',
+          help: 'Table cell headers attributes must refer to other <th> elements in the same table'
         },
         'th-has-data-cells': {
           description: 'Ensure that <th> elements and elements with role=columnheader/rowheader have data cells they describe',
@@ -30655,9 +30673,13 @@
         'td-headers-attr': {
           impact: 'serious',
           messages: {
-            pass: 'The headers attribute is exclusively used to refer to other cells in the table',
+            pass: 'The headers attribute is exclusively used to refer to other header cells in the table',
             incomplete: 'The headers attribute is empty',
-            fail: 'The headers attribute is not exclusively used to refer to other cells in the table'
+            fail: {
+              'cell-header-not-in-table': 'The headers attribute is not exclusively used to refer to other header cells in the table',
+              'cell-header-not-th': 'The headers attribute must refer to header cells, not data cells',
+              'header-refs-self': 'The element with headers attribute refers to itself'
+            }
           }
         },
         'th-has-data-cells': {