Source code
Revision control
Copy as Markdown
Other Tools
Test Info:
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
"use strict";
/* import-globals-from ../../mochitest/name.js */
loadScripts({ name: "name.js", dir: MOCHITESTS_DIR });
/**
* Test data has the format of:
* {
* desc {String} description for better logging
* expected {String} expected description value for a given accessible
* attrs {?Array} an optional list of attributes to update
* waitFor {?Array} an optional list of accessible events to wait for when
* attributes are updated
* }
*/
const tests = [
{
desc: "No description when there are no @alt, @title and @aria-describedby",
expected: "",
},
{
desc: "Description from @aria-describedby attribute",
attrs: [
{
attr: "aria-describedby",
value: "description",
},
],
waitFor: [[EVENT_DESCRIPTION_CHANGE, "image"]],
expected: "aria description",
},
{
desc:
"No description from @aria-describedby since it is the same as the " +
"@alt attribute which is used as the name",
attrs: [
{
attr: "alt",
value: "aria description",
},
],
waitFor: [[EVENT_NAME_CHANGE, "image"]],
expected: "",
},
{
desc:
"Description from @aria-describedby attribute when @alt and " +
"@aria-describedby are not the same",
attrs: [
{
attr: "aria-describedby",
value: "description2",
},
],
waitFor: [[EVENT_DESCRIPTION_CHANGE, "image"]],
expected: "another description",
},
{
desc: "No description change when @alt is dropped but @aria-describedby remains",
attrs: [
{
attr: "alt",
},
],
waitFor: [[EVENT_NAME_CHANGE, "image"]],
expected: "another description",
},
{
desc:
"Description from @aria-describedby attribute when @title (used for " +
"name) and @aria-describedby are not the same",
attrs: [
{
attr: "title",
value: "title",
},
],
waitFor: [[EVENT_NAME_CHANGE, "image"]],
expected: "another description",
},
{
desc:
"No description from @aria-describedby since it is the same as the " +
"@title attribute which is used as the name",
attrs: [
{
attr: "title",
value: "another description",
},
],
waitFor: [[EVENT_NAME_CHANGE, "image"]],
expected: "",
},
{
desc: "No description with only @title attribute which is used as the name",
attrs: [
{
attr: "aria-describedby",
},
],
waitFor: [[EVENT_DESCRIPTION_CHANGE, "image"]],
expected: "",
},
{
desc:
"Description from @title attribute when @alt and @atitle are not the " +
"same",
attrs: [
{
attr: "alt",
value: "aria description",
},
],
waitFor: [[EVENT_NAME_CHANGE, "image"]],
expected: "another description",
},
{
desc:
"No description from @title since it is the same as the @alt " +
"attribute which is used as the name",
attrs: [
{
attr: "alt",
value: "another description",
},
],
waitFor: [[EVENT_NAME_CHANGE, "image"]],
expected: "",
},
{
desc:
"No description from @aria-describedby since it is the same as the " +
"@alt (used for name) and @title attributes",
attrs: [
{
attr: "aria-describedby",
value: "description2",
},
],
waitFor: [[EVENT_DESCRIPTION_CHANGE, "image"]],
expected: "",
},
{
desc:
"Description from @aria-describedby attribute when it is different " +
"from @alt (used for name) and @title attributes",
attrs: [
{
attr: "aria-describedby",
value: "description",
},
],
waitFor: [[EVENT_DESCRIPTION_CHANGE, "image"]],
expected: "aria description",
},
{
desc:
"No description from @aria-describedby since it is the same as the " +
"@alt attribute (used for name) but different from title",
attrs: [
{
attr: "alt",
value: "aria description",
},
],
waitFor: [[EVENT_NAME_CHANGE, "image"]],
expected: "",
},
{
desc:
"Description from @aria-describedby attribute when @alt (used for " +
"name) and @aria-describedby are not the same but @title and " +
"aria-describedby are",
attrs: [
{
attr: "aria-describedby",
value: "description2",
},
],
waitFor: [[EVENT_DESCRIPTION_CHANGE, "image"]],
expected: "another description",
},
];
/**
* Test caching of accessible object description
*/
addAccessibleTask(
`
<p id="description">aria description</p>
<p id="description2">another description</p>
async function (browser, accDoc) {
let imgAcc = findAccessibleChildByID(accDoc, "image");
for (let { desc, waitFor, attrs, expected } of tests) {
info(desc);
let onUpdate;
if (waitFor) {
onUpdate = waitForOrderedEvents(waitFor);
}
if (attrs) {
for (let { attr, value } of attrs) {
await invokeSetAttribute(browser, "image", attr, value);
}
}
await onUpdate;
// When attribute change (alt) triggers reorder event, accessible will
// become defunct.
if (isDefunct(imgAcc)) {
imgAcc = findAccessibleChildByID(accDoc, "image");
}
testDescr(imgAcc, expected);
}
},
{ iframe: true, remoteIframe: true }
);
/**
* Test that the description is updated when the content of a hidden aria-describedby
* subtree changes.
*/
addAccessibleTask(
`
<button id="button" aria-describedby="desc">
<div id="desc" hidden>a</div>
`,
async function (browser, docAcc) {
const button = findAccessibleChildByID(docAcc, "button");
testDescr(button, "a");
info("Changing desc textContent");
let descChanged = waitForEvent(EVENT_DESCRIPTION_CHANGE, button);
await invokeContentTask(browser, [], () => {
content.document.getElementById("desc").textContent = "c";
});
await descChanged;
testDescr(button, "c");
info("Prepending text node to desc");
descChanged = waitForEvent(EVENT_DESCRIPTION_CHANGE, button);
await invokeContentTask(browser, [], () => {
content.document
.getElementById("desc")
.prepend(content.document.createTextNode("b"));
});
await descChanged;
testDescr(button, "bc");
},
{ chrome: true, topLevel: true, iframe: true, remoteIframe: true }
);
/**
* Test aria-description, including mutations.
*/
addAccessibleTask(
`<button id="button" aria-description="a">button</button>`,
async function (browser, docAcc) {
const button = findAccessibleChildByID(docAcc, "button");
testDescr(button, "a");
info("Changing aria-description");
let changed = waitForEvent(EVENT_DESCRIPTION_CHANGE, button);
await invokeSetAttribute(browser, "button", "aria-description", "b");
await changed;
testDescr(button, "b");
info("Removing aria-description");
changed = waitForEvent(EVENT_DESCRIPTION_CHANGE, button);
await invokeSetAttribute(browser, "button", "aria-description");
await changed;
testDescr(button, "");
info("Setting aria-description");
changed = waitForEvent(EVENT_DESCRIPTION_CHANGE, button);
await invokeSetAttribute(browser, "button", "aria-description", "c");
await changed;
testDescr(button, "c");
},
{ chrome: true, topLevel: true, iframe: true, remoteIframe: true }
);