axe-core 4.1.2-canary.ec00dc7 → 4.1.2

package/lib/rules/label-content-name-mismatch-matches.js

@@ -1,52 +1,52 @@
 import { getRole, arialabelText, arialabelledbyText } from '../commons/aria';
 import {
-  getAriaRolesSupportingNameFromContent,
-  getAriaRolesByType
+	getAriaRolesSupportingNameFromContent,
+	getAriaRolesByType
 } from '../commons/standards';
 import { sanitize, visibleVirtual } from '../commons/text';
 
 function labelContentNameMismatchMatches(node, virtualNode) {
-  /**
-   * Applicability:
-   * Rule applies to any element that has
-   * a) a semantic role that is `widget` that supports name from content
-   * b) has visible text content
-   * c) has accessible name (eg: `aria-label`)
-   */
-  const role = getRole(node);
-  if (!role) {
-    return false;
-  }
+	/**
+	 * Applicability:
+	 * Rule applies to any element that has
+	 * a) a semantic role that is `widget` that supports name from content
+	 * b) has visible text content
+	 * c) has accessible name (eg: `aria-label`)
+	 */
+	const role = getRole(node);
+	if (!role) {
+		return false;
+	}
 
-  const widgetRoles = getAriaRolesByType('widget');
-  const isWidgetType = widgetRoles.includes(role);
-  if (!isWidgetType) {
-    return false;
-  }
+	const widgetRoles = getAriaRolesByType('widget');
+	const isWidgetType = widgetRoles.includes(role);
+	if (!isWidgetType) {
+		return false;
+	}
 
-  const rolesWithNameFromContents = getAriaRolesSupportingNameFromContent();
-  if (!rolesWithNameFromContents.includes(role)) {
-    return false;
-  }
+	const rolesWithNameFromContents = getAriaRolesSupportingNameFromContent();
+	if (!rolesWithNameFromContents.includes(role)) {
+		return false;
+	}
 
-  /**
-   * if no `aria-label` or `aria-labelledby` attribute - ignore `node`
-   */
-  if (
-    !sanitize(arialabelText(virtualNode)) &&
-    !sanitize(arialabelledbyText(node))
-  ) {
-    return false;
-  }
+	/**
+	 * if no `aria-label` or `aria-labelledby` attribute - ignore `node`
+	 */
+	if (
+		!sanitize(arialabelText(virtualNode)) &&
+		!sanitize(arialabelledbyText(node))
+	) {
+		return false;
+	}
 
-  /**
-   * if no `contentText` - ignore `node`
-   */
-  if (!sanitize(visibleVirtual(virtualNode))) {
-    return false;
-  }
+	/**
+	 * if no `contentText` - ignore `node`
+	 */
+	if (!sanitize(visibleVirtual(virtualNode))) {
+		return false;
+	}
 
-  return true;
+	return true;
 }
 
 export default labelContentNameMismatchMatches;

package/lib/rules/label-content-name-mismatch.json

@@ -1,12 +1,12 @@
 {
-  "id": "label-content-name-mismatch",
-  "matches": "label-content-name-mismatch-matches",
-  "tags": ["cat.semantics", "wcag21a", "wcag253", "experimental"],
-  "metadata": {
-    "description": "Ensures that elements labelled through their content must have their visible text as part of their accessible name",
-    "help": "Elements must have their visible text as part of their accessible name"
-  },
-  "all": [],
-  "any": ["label-content-name-mismatch"],
-  "none": []
+	"id": "label-content-name-mismatch",
+	"matches": "label-content-name-mismatch-matches",
+	"tags": ["cat.semantics", "wcag21a", "wcag253", "experimental"],
+	"metadata": {
+		"description": "Ensures that elements labelled through their content must have their visible text as part of their accessible name",
+		"help": "Elements must have their visible text as part of their accessible name"
+	},
+	"all": [],
+	"any": ["label-content-name-mismatch"],
+	"none": []
 }

package/lib/rules/label-matches.js

@@ -1,15 +1,15 @@
 function labelMatches(node, virtualNode) {
-  if (
-    virtualNode.props.nodeName !== 'input' ||
-    virtualNode.hasAttr('type') === false
-  ) {
-    return true;
-  }
+	if (
+		virtualNode.props.nodeName !== 'input' ||
+		virtualNode.hasAttr('type') === false
+	) {
+		return true;
+	}
 
-  var type = virtualNode.attr('type').toLowerCase();
-  return (
-    ['hidden', 'image', 'button', 'submit', 'reset'].includes(type) === false
-  );
+	var type = virtualNode.attr('type').toLowerCase();
+	return (
+		['hidden', 'image', 'button', 'submit', 'reset'].includes(type) === false
+	);
 }
 
 export default labelMatches;

package/lib/rules/label-title-only.json

@@ -1,13 +1,13 @@
 {
-  "id": "label-title-only",
-  "selector": "input, select, textarea",
-  "matches": "label-matches",
-  "tags": ["cat.forms", "best-practice"],
-  "metadata": {
-    "description": "Ensures that every form element is not solely labeled using the title or aria-describedby attributes",
-    "help": "Form elements should have a visible label"
-  },
-  "all": [],
-  "any": [],
-  "none": ["title-only"]
+	"id": "label-title-only",
+	"selector": "input, select, textarea",
+	"matches": "label-matches",
+	"tags": ["cat.forms", "best-practice"],
+	"metadata": {
+		"description": "Ensures that every form element is not solely labeled using the title or aria-describedby attributes",
+		"help": "Form elements should have a visible label"
+	},
+	"all": [],
+	"any": [],
+	"none": ["title-only"]
 }

package/lib/rules/label.json

@@ -1,29 +1,29 @@
 {
-  "id": "label",
-  "selector": "input, textarea",
-  "matches": "label-matches",
-  "tags": [
-    "cat.forms",
-    "wcag2a",
-    "wcag412",
-    "wcag131",
-    "section508",
-    "section508.22.n",
-    "ACT"
-  ],
-  "metadata": {
-    "description": "Ensures every form element has a label",
-    "help": "Form elements must have labels"
-  },
-  "all": [],
-  "any": [
-    "implicit-label",
-    "explicit-label",
-    "aria-label",
-    "aria-labelledby",
-    "non-empty-title",
-    "non-empty-placeholder",
-    "presentational-role"
-  ],
-  "none": ["help-same-as-label", "hidden-explicit-label"]
+	"id": "label",
+	"selector": "input, textarea",
+	"matches": "label-matches",
+	"tags": [
+		"cat.forms",
+		"wcag2a",
+		"wcag412",
+		"wcag131",
+		"section508",
+		"section508.22.n",
+		"ACT"
+	],
+	"metadata": {
+		"description": "Ensures every form element has a label",
+		"help": "Form elements must have labels"
+	},
+	"all": [],
+	"any": [
+		"aria-label",
+		"aria-labelledby",
+		"implicit-label",
+		"explicit-label",
+		"non-empty-title",
+		"non-empty-placeholder",
+		"presentational-role"
+	],
+	"none": ["help-same-as-label", "hidden-explicit-label"]
 }

package/lib/rules/landmark-banner-is-top-level.json

@@ -1,13 +1,13 @@
 {
-  "id": "landmark-banner-is-top-level",
-  "selector": "header:not([role]), [role=banner]",
-  "matches": "landmark-has-body-context-matches",
-  "tags": ["cat.semantics", "best-practice"],
-  "metadata": {
-    "description": "Ensures the banner landmark is at top level",
-    "help": "Banner landmark should not be contained in another landmark"
-  },
-  "all": [],
-  "any": ["landmark-is-top-level"],
-  "none": []
+	"id": "landmark-banner-is-top-level",
+	"selector": "header:not([role]), [role=banner]",
+	"matches": "landmark-has-body-context-matches",
+	"tags": ["cat.semantics", "best-practice"],
+	"metadata": {
+		"description": "Ensures the banner landmark is at top level",
+		"help": "Banner landmark must not be contained in another landmark"
+	},
+	"all": [],
+	"any": ["landmark-is-top-level"],
+	"none": []
 }

package/lib/rules/landmark-complementary-is-top-level.json

@@ -1,12 +1,12 @@
 {
-  "id": "landmark-complementary-is-top-level",
-  "selector": "aside:not([role]), [role=complementary]",
-  "tags": ["cat.semantics", "best-practice"],
-  "metadata": {
-    "description": "Ensures the complementary landmark or aside is at top level",
-    "help": "Aside should not be contained in another landmark"
-  },
-  "all": [],
-  "any": ["landmark-is-top-level"],
-  "none": []
+	"id": "landmark-complementary-is-top-level",
+	"selector": "aside:not([role]), [role=complementary]",
+	"tags": ["cat.semantics", "best-practice"],
+	"metadata": {
+		"description": "Ensures the complementary landmark or aside is at top level",
+		"help": "Aside must not be contained in another landmark"
+	},
+	"all": [],
+	"any": ["landmark-is-top-level"],
+	"none": []
 }

package/lib/rules/landmark-contentinfo-is-top-level.json

@@ -1,13 +1,13 @@
 {
-  "id": "landmark-contentinfo-is-top-level",
-  "selector": "footer:not([role]), [role=contentinfo]",
-  "matches": "landmark-has-body-context-matches",
-  "tags": ["cat.semantics", "best-practice"],
-  "metadata": {
-    "description": "Ensures the contentinfo landmark is at top level",
-    "help": "Contentinfo landmark should not be contained in another landmark"
-  },
-  "all": [],
-  "any": ["landmark-is-top-level"],
-  "none": []
+	"id": "landmark-contentinfo-is-top-level",
+	"selector": "footer:not([role]), [role=contentinfo]",
+	"matches": "landmark-has-body-context-matches",
+	"tags": ["cat.semantics", "best-practice"],
+	"metadata": {
+		"description": "Ensures the contentinfo landmark is at top level",
+		"help": "Contentinfo landmark must not be contained in another landmark"
+	},
+	"all": [],
+	"any": ["landmark-is-top-level"],
+	"none": []
 }

package/lib/rules/landmark-has-body-context-matches.js

@@ -1,13 +1,13 @@
 import { findUpVirtual } from '../commons/dom';
 
 function landmarkHasBodyContextMatches(node, virtualNode) {
-  const nativeScopeFilter = 'article, aside, main, nav, section';
+	const nativeScopeFilter = 'article, aside, main, nav, section';
 
-  // Filter elements that, within certain contexts, don't map their role.
-  // e.g. a <header> inside a <main> is not a banner, but in the <body> context it is
-  return (
-    node.hasAttribute('role') || !findUpVirtual(virtualNode, nativeScopeFilter)
-  );
+	// Filter elements that, within certain contexts, don't map their role.
+	// e.g. a <header> inside a <main> is not a banner, but in the <body> context it is
+	return (
+		node.hasAttribute('role') || !findUpVirtual(virtualNode, nativeScopeFilter)
+	);
 }
 
 export default landmarkHasBodyContextMatches;

package/lib/rules/landmark-main-is-top-level.json

@@ -1,12 +1,12 @@
 {
-  "id": "landmark-main-is-top-level",
-  "selector": "main:not([role]), [role=main]",
-  "tags": ["cat.semantics", "best-practice"],
-  "metadata": {
-    "description": "Ensures the main landmark is at top level",
-    "help": "Main landmark should not be contained in another landmark"
-  },
-  "all": [],
-  "any": ["landmark-is-top-level"],
-  "none": []
+	"id": "landmark-main-is-top-level",
+	"selector": "main:not([role]), [role=main]",
+	"tags": ["cat.semantics", "best-practice"],
+	"metadata": {
+		"description": "Ensures the main landmark is at top level",
+		"help": "Main landmark must not be contained in another landmark"
+	},
+	"all": [],
+	"any": ["landmark-is-top-level"],
+	"none": []
 }

package/lib/rules/landmark-no-duplicate-banner.json

@@ -1,12 +1,12 @@
 {
-  "id": "landmark-no-duplicate-banner",
-  "selector": "header:not([role]), [role=banner]",
-  "tags": ["cat.semantics", "best-practice"],
-  "metadata": {
-    "description": "Ensures the document has at most one banner landmark",
-    "help": "Document should not have more than one banner landmark"
-  },
-  "all": [],
-  "any": ["page-no-duplicate-banner"],
-  "none": []
+	"id": "landmark-no-duplicate-banner",
+	"selector": "header:not([role]), [role=banner]",
+	"tags": ["cat.semantics", "best-practice"],
+	"metadata": {
+		"description": "Ensures the document has at most one banner landmark",
+		"help": "Document must not have more than one banner landmark"
+	},
+	"all": [],
+	"any": ["page-no-duplicate-banner"],
+	"none": []
 }

package/lib/rules/landmark-no-duplicate-contentinfo.json

@@ -1,12 +1,12 @@
 {
-  "id": "landmark-no-duplicate-contentinfo",
-  "selector": "footer:not([role]), [role=contentinfo]",
-  "tags": ["cat.semantics", "best-practice"],
-  "metadata": {
-    "description": "Ensures the document has at most one contentinfo landmark",
-    "help": "Document should not have more than one contentinfo landmark"
-  },
-  "all": [],
-  "any": ["page-no-duplicate-contentinfo"],
-  "none": []
+	"id": "landmark-no-duplicate-contentinfo",
+	"selector": "footer:not([role]), [role=contentinfo]",
+	"tags": ["cat.semantics", "best-practice"],
+	"metadata": {
+		"description": "Ensures the document has at most one contentinfo landmark",
+		"help": "Document must not have more than one contentinfo landmark"
+	},
+	"all": [],
+	"any": ["page-no-duplicate-contentinfo"],
+	"none": []
 }

package/lib/rules/landmark-no-duplicate-main.json

@@ -1,12 +1,12 @@
 {
-  "id": "landmark-no-duplicate-main",
-  "selector": "main:not([role]), [role=main]",
-  "tags": ["cat.semantics", "best-practice"],
-  "metadata": {
-    "description": "Ensures the document has at most one main landmark",
-    "help": "Document should not have more than one main landmark"
-  },
-  "all": [],
-  "any": ["page-no-duplicate-main"],
-  "none": []
+	"id": "landmark-no-duplicate-main",
+	"selector": "main:not([role]), [role=main]",
+	"tags": ["cat.semantics", "best-practice"],
+	"metadata": {
+		"description": "Ensures the document has at most one main landmark",
+		"help": "Document must not have more than one main landmark"
+	},
+	"all": [],
+	"any": ["page-no-duplicate-main"],
+	"none": []
 }

package/lib/rules/landmark-one-main.json

@@ -1,12 +1,12 @@
 {
-  "id": "landmark-one-main",
-  "selector": "html",
-  "tags": ["cat.semantics", "best-practice"],
-  "metadata": {
-    "description": "Ensures the document has a main landmark",
-    "help": "Document should have one main landmark"
-  },
-  "all": ["page-has-main"],
-  "any": [],
-  "none": []
+	"id": "landmark-one-main",
+	"selector": "html",
+	"tags": ["cat.semantics", "best-practice"],
+	"metadata": {
+		"description": "Ensures the document has a main landmark",
+		"help": "Document must have one main landmark"
+	},
+	"all": ["page-has-main"],
+	"any": [],
+	"none": []
 }

package/lib/rules/landmark-unique-matches.js

@@ -4,47 +4,47 @@ import { getAriaRolesByType } from '../commons/standards';
 import { accessibleTextVirtual } from '../commons/text';
 
 function landmarkUniqueMatches(node, virtualNode) {
-  /*
-   * Since this is a best-practice rule, we are filtering elements as dictated by ARIA 1.1 Practices regardless of treatment by browser/AT combinations.
-   *
-   * Info: https://www.w3.org/TR/wai-aria-practices-1.1/#aria_landmark
-   */
-  var excludedParentsForHeaderFooterLandmarks = [
-    'article',
-    'aside',
-    'main',
-    'nav',
-    'section'
-  ].join(',');
-  function isHeaderFooterLandmark(headerFooterElement) {
-    return !findUpVirtual(
-      headerFooterElement,
-      excludedParentsForHeaderFooterLandmarks
-    );
-  }
+	/*
+	 * Since this is a best-practice rule, we are filtering elements as dictated by ARIA 1.1 Practices regardless of treatment by browser/AT combinations.
+	 *
+	 * Info: https://www.w3.org/TR/wai-aria-practices-1.1/#aria_landmark
+	 */
+	var excludedParentsForHeaderFooterLandmarks = [
+		'article',
+		'aside',
+		'main',
+		'nav',
+		'section'
+	].join(',');
+	function isHeaderFooterLandmark(headerFooterElement) {
+		return !findUpVirtual(
+			headerFooterElement,
+			excludedParentsForHeaderFooterLandmarks
+		);
+	}
 
-  function isLandmarkVirtual(virtualNode) {
-    var { actualNode } = virtualNode;
-    var landmarkRoles = getAriaRolesByType('landmark');
-    var role = getRole(actualNode);
-    if (!role) {
-      return false;
-    }
+	function isLandmarkVirtual(virtualNode) {
+		var { actualNode } = virtualNode;
+		var landmarkRoles = getAriaRolesByType('landmark');
+		var role = getRole(actualNode);
+		if (!role) {
+			return false;
+		}
 
-    var nodeName = actualNode.nodeName.toUpperCase();
-    if (nodeName === 'HEADER' || nodeName === 'FOOTER') {
-      return isHeaderFooterLandmark(virtualNode);
-    }
+		var nodeName = actualNode.nodeName.toUpperCase();
+		if (nodeName === 'HEADER' || nodeName === 'FOOTER') {
+			return isHeaderFooterLandmark(virtualNode);
+		}
 
-    if (nodeName === 'SECTION' || nodeName === 'FORM') {
-      var accessibleText = accessibleTextVirtual(virtualNode);
-      return !!accessibleText;
-    }
+		if (nodeName === 'SECTION' || nodeName === 'FORM') {
+			var accessibleText = accessibleTextVirtual(virtualNode);
+			return !!accessibleText;
+		}
 
-    return landmarkRoles.indexOf(role) >= 0 || role === 'region';
-  }
+		return landmarkRoles.indexOf(role) >= 0 || role === 'region';
+	}
 
-  return isLandmarkVirtual(virtualNode) && isVisible(node, true);
+	return isLandmarkVirtual(virtualNode) && isVisible(node, true);
 }
 
 export default landmarkUniqueMatches;

package/lib/rules/landmark-unique.json

@@ -1,13 +1,13 @@
 {
-  "id": "landmark-unique",
-  "selector": "[role=banner], [role=complementary], [role=contentinfo], [role=main], [role=navigation], [role=region], [role=search], [role=form], form, footer, header, aside, main, nav, section",
-  "tags": ["cat.semantics", "best-practice"],
-  "metadata": {
-    "help": "Ensures landmarks are unique",
-    "description": "Landmarks should have a unique role or role/label/title (i.e. accessible name) combination"
-  },
-  "matches": "landmark-unique-matches",
-  "all": [],
-  "any": ["landmark-is-unique"],
-  "none": []
+	"id": "landmark-unique",
+	"selector": "[role=banner], [role=complementary], [role=contentinfo], [role=main], [role=navigation], [role=region], [role=search], [role=form], form, footer, header, aside, main, nav, section",
+	"tags": ["cat.semantics", "best-practice"],
+	"metadata": {
+		"help": "Ensures landmarks are unique",
+		"description": "Landmarks must have a unique role or role/label/title (i.e. accessible name) combination"
+	},
+	"matches": "landmark-unique-matches",
+	"all": [],
+	"any": ["landmark-is-unique"],
+	"none": []
 }

package/lib/rules/layout-table-matches.js

@@ -1,8 +1,9 @@
 import { isDataTable } from '../commons/table';
 import { isFocusable } from '../commons/dom';
 
+// TODO: es-modules add tests. No way to access this on the `axe` object
 function dataTableMatches(node) {
-  return !isDataTable(node) && !isFocusable(node);
+	return !isDataTable(node) && !isFocusable(node);
 }
 
 export default dataTableMatches;

package/lib/rules/link-in-text-block-matches.js

@@ -2,20 +2,20 @@ import { sanitize } from '../commons/text';
 import { isVisible, isInTextBlock } from '../commons/dom';
 
 function linkInTextBlockMatches(node) {
-  var text = sanitize(node.textContent);
-  var role = node.getAttribute('role');
+	var text = sanitize(node.textContent);
+	var role = node.getAttribute('role');
 
-  if (role && role !== 'link') {
-    return false;
-  }
-  if (!text) {
-    return false;
-  }
-  if (!isVisible(node, false)) {
-    return false;
-  }
+	if (role && role !== 'link') {
+		return false;
+	}
+	if (!text) {
+		return false;
+	}
+	if (!isVisible(node, false)) {
+		return false;
+	}
 
-  return isInTextBlock(node);
+	return isInTextBlock(node);
 }
 
 export default linkInTextBlockMatches;

package/lib/rules/link-in-text-block.json

@@ -1,14 +1,14 @@
 {
-  "id": "link-in-text-block",
-  "selector": "a[href], [role=link]",
-  "matches": "link-in-text-block-matches",
-  "excludeHidden": false,
-  "tags": ["cat.color", "experimental", "wcag2a", "wcag141"],
-  "metadata": {
-    "description": "Links can be distinguished without relying on color",
-    "help": "Links must be distinguished from surrounding text in a way that does not rely on color"
-  },
-  "all": ["link-in-text-block"],
-  "any": [],
-  "none": []
+	"id": "link-in-text-block",
+	"selector": "a[href], [role=link]",
+	"matches": "link-in-text-block-matches",
+	"excludeHidden": false,
+	"tags": ["cat.color", "experimental", "wcag2a", "wcag141"],
+	"metadata": {
+		"description": "Links can be distinguished without relying on color",
+		"help": "Links must be distinguished from surrounding text in a way that does not rely on color"
+	},
+	"all": ["link-in-text-block"],
+	"any": [],
+	"none": []
 }