accessibility-developer-tools/test/audits/multiple-aria-owners-test.js

This is a library of accessibility-related testing and utility code.

(function() {  // scope to avoid leaking helpers and variables to global namespace
    var RULE_NAME = 'multipleAriaOwners';

    module('MultipleAriaOwners');

    /**
     * Helper for aria-owns testing:
     *  - adds owned elements to the fixture
     *  - creates owner element/s
     *  - sets aria-owns on owners
     *  - returns the fixture
     * @param {!Array.<string>} ownedIds The ids that will be 'owned'.
     * @param {Array.<string>} ownerIds An id for each 'owner' element.
     * @param {string=} attributeValue The value of 'aria-owns'
     *    otherwise the ownedIds will be used.
     * @return {!Element} The test container (qunit fixture).
     */
    function setup(ownedIds, ownerIds, attributeValue) {
        var fixture = document.getElementById('qunit-fixture');
        var value = attributeValue || ownedIds.join(' ');
        ownedIds.forEach(function(id) {
            var element = document.createElement('div');
            element.id = id;
            fixture.appendChild(element);
        });
        ownerIds = ownerIds || [''];
        ownerIds.forEach(function(id) {
            var element = document.createElement('div');
            if (id) {  // could be an empty string, that is legit here
                element.id = id;
            }
            element.setAttribute('aria-owns', value);
            fixture.appendChild(element);
        });
        return fixture;
    }

    test('Element owned once only', function(assert) {
        var fixture = setup(['theOwned']);
        var config = {
            scope: fixture,
            ruleName: RULE_NAME,
            expected: axs.constants.AuditResult.PASS,
            elements: []
        };
        assert.runRule(config);
    });

    test('Multiple elements owned once only', function(assert) {
        var fixture = setup(['theOwnedElement', 'theOtherOwnedElement']);
        var config = {
            scope: fixture,
            ruleName: RULE_NAME,
            expected: axs.constants.AuditResult.PASS,
            elements: []
        };
        assert.runRule(config);
    });

    test('Element owned once only but not found in DOM', function(assert) {
        var id = 'theOwnedElement';
        var fixture = setup([id]);
        var element = document.getElementById(id);
        element.parentNode.removeChild(element);
        var config = {
            scope: fixture,
            ruleName: RULE_NAME,
            expected: axs.constants.AuditResult.PASS,
            elements: []
        };
        assert.runRule(config);
    });

    test('Element owned multiple times', function(assert) {
        var ownerIds = ['owner1', 'owner2'];
        var fixture = setup(['theOwned'], ownerIds);
        var elements = ownerIds.map(function(id) {
            return document.getElementById(id);
        });

        var config = {
            scope: fixture,
            ruleName: RULE_NAME,
            expected: axs.constants.AuditResult.FAIL,
            elements: elements
        };
        assert.runRule(config);
    });

    test('Multiple elements owned multiple times', function(assert) {
        var ownerIds = ['owner1', 'owner2', 'owner3'];
        var fixture = setup(['theOwnedElement', 'theOtherOwnedElement'], ownerIds);
        var elements = ownerIds.map(function(id) {
            return document.getElementById(id);
        });

        var config = {
            scope: fixture,
            ruleName: RULE_NAME,
            expected: axs.constants.AuditResult.FAIL,
            elements: elements
        };
        assert.runRule(config);
    });


    test('Multiple elements one owned multiple times', function(assert) {
        var ownerIds = ['owner1', 'owner2'];
        var ownedElements = ['theOwnedElement', 'theOtherOwnedElement'];
        var fixture = setup(ownedElements, ownerIds, ownedElements[0]);
        var elements = ownerIds.map(function(id) {
            return document.getElementById(id);
        });

        var config = {
            scope: fixture,
            ruleName: RULE_NAME,
            expected: axs.constants.AuditResult.FAIL,
            elements: elements
        };
        assert.runRule(config);
    });

    test('Using ignoreSelectors', function(assert) {
        var fixture = setup(['theOwned'], ['owner1', 'owner2']);
        var ignoreSelectors = ['#owner1', '#owner2'];

        var config = {
            ignoreSelectors: ignoreSelectors,
            scope: fixture,
            ruleName: RULE_NAME,
            expected: axs.constants.AuditResult.NA
        };
        assert.runRule(config);
    });
})();