axe-core 4.2.4 → 4.3.0

package/lib/core/utils/closest.js

@@ -1,30 +0,0 @@
-import matches from './matches';
-
-/**
- * closest implementation that operates on a VirtualNode
- *
- * @method closest
- * @memberof axe.utils
- * @param {VirtualNode} vNode VirtualNode to match
- * @param {String} selector CSS selector string
- * @return {VirtualNode | null}
- */
-function closest(vNode, selector) {
-  while (vNode) {
-    if (matches(vNode, selector)) {
-      return vNode;
-    }
-
-    // the top node of the tree will have parent === null, so a
-    // undefined parent means we are in a disconnected tree
-    if (typeof vNode.parent === 'undefined') {
-      throw new TypeError('Cannot resolve parent for non-DOM nodes');
-    }
-
-    vNode = vNode.parent;
-  }
-
-  return null;
-}
-
-export default closest;

package/lib/core/utils/collect-results-from-frames.js

@@ -1,84 +0,0 @@
-import queue from './queue';
-import sendCommandToFrame from './send-command-to-frame';
-import mergeResults from './merge-results';
-import getSelector from './get-selector';
-
-/**
- * Sends a message to axe running in frames to start analysis and collate results (via `mergeResults`)
- * @private
- * @param  {Context}  parentContent   The resolved Context object
- * @param  {Object}   options   Options object (as passed to `runRules`)
- * @param  {string}   command   Command sent to all frames
- * @param  {Array}    parameter Array of values to be passed along side the command
- * @param  {Function} callback  Function to call when results from all frames have returned
- */
-function collectResultsFromFrames(
-  parentContent,
-  options,
-  command,
-  parameter,
-  resolve,
-  reject
-) {
-  var q = queue();
-  var frames = parentContent.frames;
-
-  // Tell each axe running in each frame to collect results
-  frames.forEach(frame => {
-    const tabindex = parseInt(frame.node.getAttribute('tabindex'), 10);
-    const focusable = isNaN(tabindex) || tabindex >= 0;
-
-    const rect = frame.node.getBoundingClientRect();
-    let width = parseInt(frame.node.getAttribute('width'), 10);
-    let height = parseInt(frame.node.getAttribute('height'), 10);
-    width = isNaN(width) ? rect.width : width;
-    height = isNaN(height) ? rect.height : height;
-
-    var params = {
-      options: options,
-      command: command,
-      parameter: parameter,
-      context: {
-        initiator: false,
-
-        // if any parent iframe is not focusable then the entire
-        // iframe stack is not focusable (even if the descendant
-        // iframe has tabindex=0 on it)
-        focusable: parentContent.focusable === false ? false : focusable,
-        boundingClientRect: {
-          width: width,
-          height: height
-        },
-        page: parentContent.page,
-        include: frame.include || [],
-        exclude: frame.exclude || []
-      }
-    };
-
-    q.defer((res, rej) => {
-      var node = frame.node;
-      sendCommandToFrame(
-        node,
-        params,
-        data => {
-          if (data) {
-            return res({
-              results: data,
-              frameElement: node,
-              frame: getSelector(node)
-            });
-          }
-          res(null);
-        },
-        rej
-      );
-    });
-  });
-
-  // Combine results from all frames and give it back
-  q.then(data => {
-    resolve(mergeResults(data, options));
-  }).catch(reject);
-}
-
-export default collectResultsFromFrames;

package/lib/core/utils/contains.js

@@ -1,46 +0,0 @@
-/**
- * Wrapper for Node#contains
- * @method contains
- * @memberof axe.utils
- * @param  {VirtualNode} vNode     The candidate container VirtualNode
- * @param  {VirtualNode} otherVNode The vNode to test is contained by `vNode`
- * @return {Boolean}           Whether `vNode` contains `otherVNode`
- */
-function contains(vNode, otherVNode) {
-  /*eslint no-bitwise: 0*/
-
-  function containsShadowChild(vNode, otherVNode) {
-    if (vNode.shadowId === otherVNode.shadowId) {
-      return true;
-    }
-    return !!vNode.children.find(child => {
-      return containsShadowChild(child, otherVNode);
-    });
-  }
-
-  if (vNode.shadowId || otherVNode.shadowId) {
-    return containsShadowChild(vNode, otherVNode);
-  }
-
-  if (vNode.actualNode) {
-    if (typeof vNode.actualNode.contains === 'function') {
-      return vNode.actualNode.contains(otherVNode.actualNode);
-    }
-
-    return !!(
-      vNode.actualNode.compareDocumentPosition(otherVNode.actualNode) & 16
-    );
-  } else {
-    // fallback for virtualNode only contexts (e.g. linting)
-    // @see https://github.com/Financial-Times/polyfill-service/pull/183/files
-    do {
-      if (otherVNode === vNode) {
-        return true;
-      }
-    } while ((otherVNode = otherVNode && otherVNode.parent));
-  }
-
-  return false;
-}
-
-export default contains;

package/lib/core/utils/css-parser.js

@@ -1,9 +0,0 @@
-import { CssSelectorParser } from 'css-selector-parser';
-
-const parser = new CssSelectorParser();
-parser.registerSelectorPseudos('not');
-parser.registerSelectorPseudos('is');
-parser.registerNestingOperators('>');
-parser.registerAttrEqualityMods('^', '$', '*', '~');
-
-export default parser;

package/lib/core/utils/deep-merge.js

@@ -1,31 +0,0 @@
-/**
- * Deeply merge two objects into a new object without changing any of the source objects.
- * @see https://medium.com/javascript-in-plain-english/how-to-merge-objects-in-javascript-98f2209710e3
- * @param {...Object} sources
- * @return {Object}
- */
-function deepMerge(...sources) {
-  const target = {};
-
-  sources.forEach(source => {
-    if (!source || typeof source !== 'object' || Array.isArray(source)) {
-      return;
-    }
-
-    for (const key of Object.keys(source)) {
-      if (
-        !target.hasOwnProperty(key) ||
-        typeof source[key] !== 'object' ||
-        Array.isArray(target[key])
-      ) {
-        target[key] = source[key];
-      } else {
-        target[key] = deepMerge(target[key], source[key]);
-      }
-    }
-  });
-
-  return target;
-}
-
-export default deepMerge;

package/lib/core/utils/dq-element.js

@@ -1,131 +0,0 @@
-import getSelector from './get-selector';
-import getAncestry from './get-ancestry';
-import getXpath from './get-xpath';
-import getNodeFromTree from './get-node-from-tree';
-import AbstractVirtualNode from '../base/virtual-node/abstract-virtual-node';
-
-function truncate(str, maxLength) {
-  maxLength = maxLength || 300;
-
-  if (str.length > maxLength) {
-    var index = str.indexOf('>');
-    str = str.substring(0, index + 1);
-  }
-
-  return str;
-}
-
-function getSource(element) {
-  if (!element?.outerHTML) {
-    return '';
-  }
-  var source = element.outerHTML;
-  if (!source && typeof XMLSerializer === 'function') {
-    source = new XMLSerializer().serializeToString(element);
-  }
-  return truncate(source || '');
-}
-
-/**
- * "Serialized" `HTMLElement`. It will calculate the CSS selector,
- * grab the source (outerHTML) and offer an array for storing frame paths
- * @param {HTMLElement} element The element to serialize
- * @param {Object} spec Properties to use in place of the element when instantiated on Elements from other frames
- */
-function DqElement(elm, options = {}, spec = {}) {
-  this.spec = spec;
-  if (elm instanceof AbstractVirtualNode) {
-    this._virtualNode = elm;
-    this._element = elm.actualNode;
-  } else {
-    this._element = elm;
-    this._virtualNode = getNodeFromTree(elm);
-  }
-
-  /**
-   * Whether DqElement was created from an iframe
-   * @type {boolean}
-   */
-  this.fromFrame = this.spec.selector?.length > 1;
-
-  if (options.absolutePaths) {
-    this._options = { toRoot: true };
-  }
-
-  /**
-   * Number by which nodes in the flat tree can be sorted
-   * @type {Number}
-   */
-  this.nodeIndexes = [];
-  if (Array.isArray(this.spec.nodeIndexes)) {
-    this.nodeIndexes = this.spec.nodeIndexes;
-  } else if (typeof this._virtualNode?.nodeIndex === 'number') {
-    this.nodeIndexes = [this._virtualNode.nodeIndex];
-  }
-
-  /**
-   * The generated HTML source code of the element
-   * @type {String|null}
-   */
-  this.source = null;
-  // TODO: es-modules_audit
-  if (!axe._audit.noHtml) {
-    this.source = this.spec.source ?? getSource(this._element);
-  }
-}
-
-DqElement.prototype = {
-  /**
-   * A unique CSS selector for the element, designed for readability
-   * @return {String}
-   */
-  get selector() {
-    return this.spec.selector || [getSelector(this.element, this._options)];
-  },
-
-  /**
-   * A unique CSS selector for the element, including its ancestors down to the root node
-   * @return {String}
-   */
-  get ancestry() {
-    return this.spec.ancestry || [getAncestry(this.element)];
-  },
-
-  /**
-   * Xpath to the element
-   * @return {String}
-   */
-  get xpath() {
-    return this.spec.xpath || [getXpath(this.element)];
-  },
-
-  /**
-   * Direct reference to the `HTMLElement` wrapped by this `DQElement`.
-   */
-  get element() {
-    return this._element;
-  },
-
-  toJSON() {
-    return {
-      selector: this.selector,
-      source: this.source,
-      xpath: this.xpath,
-      ancestry: this.ancestry,
-      nodeIndexes: this.nodeIndexes
-    };
-  }
-};
-
-DqElement.fromFrame = function fromFrame(node, options, frame) {
-  const spec = {
-    ...node,
-    selector: [...frame.selector, ...node.selector],
-    ancestry: [...frame.ancestry, ...node.ancestry],
-    xpath: [...frame.xpath, ...node.xpath],
-    nodeIndexes: [...frame.nodeIndexes, ...node.nodeIndexes]
-  };
-  return new DqElement(frame.element, options, spec);
-};
-
-export default DqElement;

package/lib/core/utils/element-matches.js

@@ -1,43 +0,0 @@
-/**
- * Polyfill for Element#matches
- * @param {HTMLElement} node The element to test
- * @param {String} selector The selector to test element against
- * @return {Boolean}
- */
-const matchesSelector = (() => {
-  var method;
-
-  function getMethod(node) {
-    var index,
-      candidate,
-      candidates = [
-        'matches',
-        'matchesSelector',
-        'mozMatchesSelector',
-        'webkitMatchesSelector',
-        'msMatchesSelector'
-      ],
-      length = candidates.length;
-
-    for (index = 0; index < length; index++) {
-      candidate = candidates[index];
-      if (node[candidate]) {
-        return candidate;
-      }
-    }
-  }
-
-  return (node, selector) => {
-    if (!method || !node[method]) {
-      method = getMethod(node);
-    }
-
-    if (node[method]) {
-      return node[method](selector);
-    }
-
-    return false;
-  };
-})();
-
-export default matchesSelector;

package/lib/core/utils/escape-selector.js

@@ -1,79 +0,0 @@
-/**
- * Escapes a property value of a CSS selector
- * @see https://github.com/mathiasbynens/CSS.escape/
- * @see http://dev.w3.org/csswg/cssom/#serialize-an-identifier
- * @param  {String} value The piece of the selector to escape
- * @return {String}        The escaped selector
- */
-function escapeSelector(value) {
-  /*eslint no-bitwise: 0, eqeqeq: 0, one-var: 0 */
-  var string = String(value);
-  var length = string.length;
-  var index = -1;
-  var codeUnit;
-  var result = '';
-  var firstCodeUnit = string.charCodeAt(0);
-  while (++index < length) {
-    codeUnit = string.charCodeAt(index);
-    // Note: there’s no need to special-case astral symbols, surrogate
-    // pairs, or lone surrogates.
-
-    // If the character is NULL (U+0000), then the REPLACEMENT CHARACTER
-    // (U+FFFD).
-    if (codeUnit == 0x0000) {
-      result += '\uFFFD';
-      continue;
-    }
-
-    if (
-      // If the character is in the range [\1-\1F] (U+0001 to U+001F) or is
-      // U+007F, […]
-      (codeUnit >= 0x0001 && codeUnit <= 0x001f) ||
-      codeUnit == 0x007f ||
-      // If the character is the first character and is in the range [0-9]
-      // (U+0030 to U+0039), […]
-      (index == 0 && codeUnit >= 0x0030 && codeUnit <= 0x0039) ||
-      // If the character is the second character and is in the range [0-9]
-      // (U+0030 to U+0039) and the first character is a `-` (U+002D), […]
-      (index == 1 &&
-        codeUnit >= 0x0030 &&
-        codeUnit <= 0x0039 &&
-        firstCodeUnit == 0x002d)
-    ) {
-      // https://drafts.csswg.org/cssom/#escape-a-character-as-code-point
-      result += '\\' + codeUnit.toString(16) + ' ';
-      continue;
-    }
-
-    // If the character is the first character and is a `-` (U+002D), and
-    // there is no second character, […]
-    if (index == 0 && length == 1 && codeUnit == 0x002d) {
-      result += '\\' + string.charAt(index);
-      continue;
-    }
-
-    // If the character is not handled by one of the above rules and is
-    // greater than or equal to U+0080, is `-` (U+002D) or `_` (U+005F), or
-    // is in one of the ranges [0-9] (U+0030 to U+0039), [A-Z] (U+0041 to
-    // U+005A), or [a-z] (U+0061 to U+007A), […]
-    if (
-      codeUnit >= 0x0080 ||
-      codeUnit == 0x002d ||
-      codeUnit == 0x005f ||
-      (codeUnit >= 0x0030 && codeUnit <= 0x0039) ||
-      (codeUnit >= 0x0041 && codeUnit <= 0x005a) ||
-      (codeUnit >= 0x0061 && codeUnit <= 0x007a)
-    ) {
-      // the character itself
-      result += string.charAt(index);
-      continue;
-    }
-
-    // Otherwise, the escaped character.
-    // https://drafts.csswg.org/cssom/#escape-a-character
-    result += '\\' + string.charAt(index);
-  }
-  return result;
-}
-
-export default escapeSelector;

package/lib/core/utils/extend-meta-data.js

@@ -1,20 +0,0 @@
-/**
- * Extends metadata onto result object and executes any functions
- * @param  {Object} to   The target of the extend
- * @param  {Object} from Metadata to extend
- */
-function extendMetaData(to, from) {
-  Object.assign(to, from);
-  Object.keys(from)
-    .filter(prop => typeof from[prop] === 'function')
-    .forEach(prop => {
-      to[prop] = null;
-      try {
-        to[prop] = from[prop](to);
-      } catch (e) {
-        // Ignore
-      }
-    });
-}
-
-export default extendMetaData;

package/lib/core/utils/filter-html-attrs.js

@@ -1,75 +0,0 @@
-import cache from '../base/cache';
-import getNodeAttributes from './get-node-attributes';
-import matchesSelector from './element-matches';
-
-/**
- * Test if node and attribute match one of the filtered attributes.
- * @param {HTMLElement} node - node to match
- * @param {String} attrname - Name of the attribute to test
- * @param {Object} filterAttrs - Attributes to remove and the qualifier of when to remove them.
- */
-function attributeMatches(node, attrName, filterAttrs) {
-  if (typeof filterAttrs[attrName] === 'undefined') {
-    return false;
-  }
-
-  // filterAttrs can only be a boolean or a CSS selector
-  if (filterAttrs[attrName] === true) {
-    return true;
-  }
-
-  return matchesSelector(node, filterAttrs[attrName]);
-}
-
-/**
- * Filter attributes from an html element and all of its children.
- *
- * Example:
- * ```js
- * // Remove attribute if present
- * axe.utils.filterHtmlAttrs('<div data-attr="foo">my div</div>', { 'data-attr': true });
- *
- * // Remove attribute if CSS selector matches
- * axe.utils.filterHtmlAttrs('<div data-attr="foo">my div</div>', { 'data-attr': 'div' });
- * ```
- *
- * @method filterHtmlAttrs
- * @memberof axe.utils
- * @param {HTMLElement} element - HTML element to remove attributes from
- * @param {Object} filterAttrs - Attributes to remove and the qualifier of when to remove them
- * @returns {HTMLElement} Element with filtered attributes removed
- */
-function filterHtmlAttrs(element, filterAttrs) {
-  if (!filterAttrs) {
-    return element;
-  }
-
-  let node = element.cloneNode(false);
-  const outerHTML = node.outerHTML;
-  const attributes = getNodeAttributes(node);
-
-  if (cache.get(outerHTML)) {
-    node = cache.get(outerHTML);
-  } else if (attributes) {
-    node = document.createElement(node.nodeName);
-    Array.from(attributes).forEach(attr => {
-      if (!attributeMatches(element, attr.name, filterAttrs)) {
-        // can't remove the value attribute from an input in IE11 so
-        // we'll have to reconstruct the node and set attribute
-        // manually
-        node.setAttribute(attr.name, attr.value);
-      }
-    });
-
-    cache.set(outerHTML, node);
-  }
-
-  // be sure to append text nodes as well
-  Array.from(element.childNodes).forEach(child => {
-    node.appendChild(filterHtmlAttrs(child, filterAttrs));
-  });
-
-  return node;
-}
-
-export default filterHtmlAttrs;

package/lib/core/utils/finalize-result.js

@@ -1,28 +0,0 @@
-import aggregateNodeResults from './aggregate-node-results';
-
-/**
- * Process rule results, grouping them by outcome
- * @param ruleResult {object}
- * @return {object}
- */
-function finalizeRuleResult(ruleResult) {
-  // we don't use getRule so that this code does not throw but returns
-  // the results
-  const rule = axe._audit.rules.find(rule => rule.id === ruleResult.id);
-  if (rule && rule.impact) {
-    ruleResult.nodes.forEach(node => {
-      ['any', 'all', 'none'].forEach(checkType => {
-        (node[checkType] || []).forEach(checkResult => {
-          checkResult.impact = rule.impact;
-        });
-      });
-    });
-  }
-
-  Object.assign(ruleResult, aggregateNodeResults(ruleResult.nodes));
-  delete ruleResult.nodes;
-
-  return ruleResult;
-}
-
-export default finalizeRuleResult;

package/lib/core/utils/find-by.js

@@ -1,16 +0,0 @@
-/**
- * Iterates an array of objects looking for a property with a specific value
- * @method findBy
- * @memberof axe.utils
- * @param  {Array} array  The array of objects to iterate
- * @param  {String} key   The property name to test against
- * @param  {Mixed} value  The value to find
- * @return {Object}       The first matching object or `undefined` if no match
- */
-function findBy(array, key, value) {
-  if (Array.isArray(array)) {
-    return array.find(obj => typeof obj === 'object' && obj[key] === value);
-  }
-}
-
-export default findBy;

package/lib/core/utils/frame-messenger/assert-window.js

@@ -1,21 +0,0 @@
-import assert from '../assert';
-
-export function assertIsParentWindow(win) {
-  assetNotGlobalWindow(win);
-  assert(
-    window.parent === win,
-    'Source of the response must be the parent window.'
-  );
-}
-
-export function assertIsFrameWindow(win) {
-  assetNotGlobalWindow(win);
-  assert(
-    win.parent === window,
-    'Respondable target must be a frame in the current window'
-  );
-}
-
-export function assetNotGlobalWindow(win) {
-  assert(window !== win, 'Messages can not be sent to the same window.');
-}

package/lib/core/utils/frame-messenger/channel-store.js

@@ -1,23 +0,0 @@
-import assert from '../assert';
-
-const channels = {};
-
-export function storeReplyHandler(
-  channelId,
-  replyHandler,
-  sendToParent = true
-) {
-  assert(
-    !channels[channelId],
-    `A replyHandler already exists for this message channel.`
-  );
-  channels[channelId] = { replyHandler, sendToParent };
-}
-
-export function getReplyHandler(channelId) {
-  return channels[channelId];
-}
-
-export function deleteReplyHandler(channelId) {
-  delete channels[channelId];
-}

package/lib/core/utils/frame-messenger/create-responder.js

@@ -1,15 +0,0 @@
-import { postMessage } from './post-message';
-
-/**
- * Helper closure to create a function that may be used to respond to a message
- * @private
- * @param  {Window} win    The window from which the message originated
- * @param  {String} channelId   The "unique" ID of the original message
- * @return {Function}      A function that may be invoked to respond to the message
- */
-export function createResponder(win, channelId, sendToParent = true) {
-  return function respond(message, keepalive, replyHandler) {
-    const data = { channelId, message, keepalive };
-    postMessage(win, data, sendToParent, replyHandler);
-  };
-}