dequelabs · jeeyyy · Jan 15, 2020 · Jun 5, 2019 · Jun 18, 2019 · Jun 20, 2019
@@ -39,6 +39,7 @@
 | html-has-lang                       | Ensures every HTML document has a lang attribute                                                                           | Serious            | cat.language, wcag2a, wcag311                                                | true               |
 | html-lang-valid                     | Ensures the lang attribute of the &lt;html&gt; element has a valid value                                                   | Serious            | cat.language, wcag2a, wcag311                                                | true               |
 | html-xml-lang-mismatch              | Ensure that HTML elements with both valid lang and xml:lang attributes agree on the base language of the page              | Moderate           | cat.language, wcag2a, wcag311                                                | true               |
+| identical-links-same-purpose        | Ensures that links with identical accessible names resolve to the same resource                                            | Minor              | wcag2aaa, wcag249, experimental                                              | true               |
 | image-alt                           | Ensures &lt;img&gt; elements have alternate text or a role of none or presentation                                         | Critical           | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a          | true               |
 | image-redundant-alt                 | Ensure button and link text is not repeated as image alternative                                                           | Minor              | cat.text-alternatives, best-practice                                         | true               |
 | input-image-alt                     | Ensures &lt;input type=&quot;image&quot;&gt; elements have alternate text                                                  | Critical           | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a          | true               |

@@ -0,0 +1,50 @@
+/**
+ * Skip unless there are more than a single result
+ */
+if (results.length < 2) {
+	return results;
+}
+
+/**
+ * for each result
+ * - get other results with matching accessible name
+ * - check if same purpose is served
+ *  - if not change `result` to `undefined`
+ */
+for (let index = 0; index < results.length; index++) {
+	const { accessibleText, linkResource } = results[index].data;
+	const identicalLinks = getIdenticalLinks(accessibleText, index);
+
+	if (!hasSamePurpose(linkResource, identicalLinks)) {
+		results[index].result = undefined;
+	}
+}
+
+return results;
+
+/**
+ * Get list of items from results which match a prescribed accessible name
+ * @param {String} expectedAccessibleText accessible name to be matched
+ * @param {Number} excludeIndex exclude `index` of result, that should not be taken into consideration
+ * @returns {Array<Object>}
+ */
+function getIdenticalLinks(expectedAccessibleText, excludeIndex) {
+	return results.filter(
+		({ data: { accessibleText } }, index) =>
+			index !== excludeIndex && accessibleText === expectedAccessibleText
+	);
+}
+
+/**
+ * Check if a given set of links have same resource
+ * @param {String} expectedResource resource string
+ * @param {Array<Object>} identicalLinks results where `data.accessibleText` were identical
+ * @returns {Boolean}
+ */
+function hasSamePurpose(expectedResource, identicalLinks) {
+	return identicalLinks.every(({ data: { linkResource } }) => {
+		const expected = expectedResource.replace(/\s/g, '').toLowerCase();
+		const actual = linkResource.replace(/\s/g, '').toLowerCase();
+		return expected === actual;
+	});
+}
@@ -0,0 +1,48 @@
+/**
+ * Note:
+ * `identical-links-same-purpose-after` fn, helps reconcile the results & alter the CheckResult accordingly
+ */
+const { text } = axe.commons;
+const accessibleText = text.accessibleTextVirtual(virtualNode);
+const linkResource = getLinkResource(node);
+
+if (!linkResource) {
+	return undefined;
+}
+
+/**
+ * Set `data` for use in `after` fn
+ */
+this.data({
+	accessibleText,
+	linkResource
+});
+
+return true;
+
+/**
+ * Get resource that a element points to (eg: href or location redirects)
+ * @param {HTMLElement} el Element
+ * @returns {String|null}
+ */
+function getLinkResource(el) {
+	if (el.hasAttribute('href')) {
+		return el.getAttribute('href');
+	}
+
+	const resourceAttr = Array.from(axe.utils.getNodeAttributes(node)).find(
+		({ value }) => {
+			/**
+			 * get any attribute which has `location.` or `location=` in its value
+			 */
+			const attrValue = value.replace(/\s/g, '');
+			return /^location[\.\=]/.test(attrValue);
+		}
+	);
+
+	if (resourceAttr) {
+		return resourceAttr.value;
+	}
+
+	return null;
+}
@@ -0,0 +1,12 @@
+{
+	"id": "identical-links-same-purpose",
+	"evaluate": "identical-links-same-purpose.js",
+	"after": "identical-links-same-purpose-after.js",
+	"metadata": {
+		"impact": "minor",
+		"messages": {
+			"pass": "Identical links (if any) resolve to same purpose",
+			"incomplete": "Fix purpose of links with same accessible name"
+		}
+	}
+}
@@ -0,0 +1,6 @@
+const { aria, text } = axe.commons;
+
+const role = aria.getRole(node);
+const accText = text.accessibleTextVirtual(virtualNode);
+
+return role === `link` && !!accText;
@@ -0,0 +1,13 @@
+{
+	"id": "identical-links-same-purpose",
+	"selector": "a, area, [role=link]",
+	"matches": "identical-links-same-purpose-matches.js",
+	"tags": ["wcag2aaa", "wcag249", "experimental"],
+	"metadata": {
+		"description": "Ensures that links with identical accessible names resolve to the same resource",
+		"help": "Links with resolve to same or equivalent resources"
+	},
+	"all": ["identical-links-same-purpose"],
+	"any": [],
+	"none": []
+}
@@ -0,0 +1,118 @@
+describe('identical-links-same-purpose tests', function() {
+	'use strict';
+
+	var fixture = document.getElementById('fixture');
+	var queryFixture = axe.testUtils.queryFixture;
+	var check = checks['identical-links-same-purpose'];
+	var checkContext = axe.testUtils.MockCheckContext();
+	var options = {};
+
+	afterEach(function() {
+		fixture.innerHTML = '';
+		checkContext.reset();
+	});
+
+	it('returns undefined when element does not have a resource (empty href)', function() {
+		var vNode = queryFixture('<a id="target" href="">Go to google.com</a>');
+		var actual = check.evaluate.call(
+			checkContext,
+			vNode.actualNode,
+			options,
+			vNode
+		);
+		assert.isUndefined(actual);
+		assert.isNull(checkContext._data);
+	});
+
+	it('returns undefined when element does not have a resource (onclick does not change location)', function() {
+		var vNode = queryFixture(
+			'<span id="target" role="link" tabindex="0" onclick="return false;">Link text</span>'
+		);
+		var actual = check.evaluate.call(
+			checkContext,
+			vNode.actualNode,
+			options,
+			vNode
+		);
+		assert.isUndefined(actual);
+		assert.isNull(checkContext._data);
+	});
+
+	it('returns true when element has location resource', function() {
+		var vNode = queryFixture(
+			'<a id="target" href="http://facebook.com">Follow us</a>'
+		);
+		var actual = check.evaluate.call(
+			checkContext,
+			vNode.actualNode,
+			options,
+			vNode
+		);
+		assert.isTrue(actual);
+		assert.hasAllKeys(checkContext._data, ['accessibleText', 'linkResource']);
+	});
+
+	it('returns true when element has location resource', function() {
+		var vNode = queryFixture(
+			'<span id="target" role="link" tabindex="0" onclick="location=\'/pages/index.html\'">Link text</span>'
+		);
+		var actual = check.evaluate.call(
+			checkContext,
+			vNode.actualNode,
+			options,
+			vNode
+		);
+		assert.isTrue(actual);
+		assert.hasAllKeys(checkContext._data, ['accessibleText', 'linkResource']);
+	});
+
+	describe('after', function() {
+		it('sets results of check result to `undefined` if links do not serve identical purpose', function() {
+			var checkResults = [
+				{
+					data: {
+						accessibleText: 'follow us',
+						linkResource: 'http://facebook.com'
+					},
+					result: true
+				},
+				{
+					data: {
+						accessibleText: 'follow us',
+						linkResource: 'http://instagram.com'
+					},
+					result: true
+				}
+			];
+			var results = check.after(checkResults);
+
+			assert.lengthOf(results, 2);
+			assert.isUndefined(results[0].result);
+			assert.isUndefined(results[1].result);
+		});
+
+		it('sets results of check result to `true` if links serve identical purpose', function() {
+			var checkResults = [
+				{
+					data: {
+						accessibleText: 'follow us',
+						linkResource: 'http://instagram.com/axe'
+					},
+					result: true
+				},
+				{
+					data: {
+						accessibleText: 'follow us',
+						linkResource: 'http://instagram.com/axe'
+					},
+					result: true
+				}
+			];
+			var results = check.after(checkResults);
+
+			assert.lengthOf(results, 2);
+			assert.isTrue(results[0].result);
+			assert.isTrue(results[1].result);
+		});
+	});
+});
diff --git a/test/integration/full/identical-links-same-purpose/incomplete.html b/test/integration/full/identical-links-same-purpose/incomplete.html
@@ -0,0 +1,39 @@
+<!DOCTYPE html>
+<html lang="en">
+	<head>
+		<title>identical-links-same-purpose test</title>
+		<meta charset="utf8" />
+		<link
+			rel="stylesheet"
+			type="text/css"
+			href="/node_modules/mocha/mocha.css"
+		/>
+		<script src="/node_modules/mocha/mocha.js"></script>
+		<script src="/node_modules/chai/chai.js"></script>
+		<script>
+			mocha.setup({
+				timeout: 50000,
+				ui: 'bdd'
+			});
+			var assert = chai.assert;
+		</script>
+		<script src="/axe.js"></script>
+	</head>
+
+	<body>
+		<!-- Hiding mocha div so that the links generated by mocha stats do not intervene -->
+		<!-- <div id="mocha"></div> -->
+
+		<!-- Links #1 -->
+		<a href="/about/contact.html">Contact</a>
+		<a href="/admissions/contact.html">Contact</a>
+
+		<!-- Links #2 -->
+		<a href="http://facebook.com"><img src="facebook.jpg" alt="Follow us"/></a>
+		<a href="http://twitter.com"><img src="twitter.jpg" alt="Follow us"/></a>
+
+		<script src="/test/testutils.js"></script>
+		<script src="incomplete.js"></script>
+		<script src="/test/integration/adapter.js"></script>
+	</body>
+</html>
diff --git a/test/integration/full/identical-links-same-purpose/incomplete.js b/test/integration/full/identical-links-same-purpose/incomplete.js
@@ -0,0 +1,26 @@
+describe('identical-links-same-purpose incomplete test', function() {
+	'use strict';
+
+	var runConfig = {
+		runOnly: {
+			type: 'rule',
+			values: ['identical-links-same-purpose']
+		}
+	};
+
+	it('returns incomplete results and no passes', function(done) {
+		axe.run(runConfig, function(err, res) {
+			assert.isNull(err);
+			assert.isDefined(res);
+
+			assert.lengthOf(res.passes, 0);
+			assert.lengthOf(res.incomplete, 1);
+			assert.lengthOf(res.incomplete[0].nodes, 4);
+			assert.equal(
+				res.incomplete[0].nodes[0].html,
+				'<a href="/about/contact.html">Contact</a>'
+			);
+			done();
+		});
+	});
+});
diff --git a/test/integration/full/identical-links-same-purpose/passes.html b/test/integration/full/identical-links-same-purpose/passes.html
@@ -0,0 +1,55 @@
+<!DOCTYPE html>
+<html lang="en">
+	<head>
+		<title>identical-links-same-purpose test</title>
+		<meta charset="utf8" />
+		<link
+			rel="stylesheet"
+			type="text/css"
+			href="/node_modules/mocha/mocha.css"
+		/>
+		<script src="/node_modules/mocha/mocha.js"></script>
+		<script src="/node_modules/chai/chai.js"></script>
+		<script>
+			mocha.setup({
+				timeout: 50000,
+				ui: 'bdd'
+			});
+			var assert = chai.assert;
+		</script>
+		<script src="/axe.js"></script>
+	</head>
+
+	<body>
+		<!-- Hiding mocha div so that the links generated by mocha stats do not intervene -->
+		<div id="mocha"></div>
+
+		<!-- Identical Links #1 -->
+		<a href="/about/contact.html">Contact</a>
+		<a href="/about/contact.html">Contact</a>
+
+		<!-- Identical Links #2 -->
+		<a href="/company/index.html#contact">Contact Us</a>
+		<a href="/company/index.html#contact">Contact Us</a>
+
+		<!-- Identical Links #3 -->
+		<span
+			role="link"
+			tabindex="0"
+			onclick="location='https://www.holland.com/global/tourism.htm'"
+		>
+			Visit Netherlands
+		</span>
+		<span
+			role="link"
+			tabindex="0"
+			onclick="location='https://www.holland.com/global/tourism.htm'"
+		>
+			Visit Netherlands
+		</span>
+
+		<script src="/test/testutils.js"></script>
+		<script src="passes.js"></script>
+		<script src="/test/integration/adapter.js"></script>
+	</body>
+</html>