Source code
Revision control
Copy as Markdown
Other Tools
/* 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
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
"use strict";
/* exported CommonUtils, testChildAtPoint, Layout, hitTest, testOffsetAtPoint */
// Load the shared-head file first.
Services.scriptloader.loadSubScript(
this
);
/* import-globals-from ../../mochitest/role.js */
// Loading and common.js from accessible/tests/mochitest/ for all tests, as
// well as promisified-events.js and role.js.
loadScripts(
{ name: "common.js", dir: MOCHITESTS_DIR },
{ name: "promisified-events.js", dir: MOCHITESTS_DIR },
{ name: "role.js", dir: MOCHITESTS_DIR }
);
const { CommonUtils } = ChromeUtils.importESModule(
);
const { Layout } = ChromeUtils.importESModule(
);
function getChildAtPoint(container, x, y, findDeepestChild) {
try {
return findDeepestChild
? container.getDeepestChildAtPoint(x, y)
: container.getChildAtPoint(x, y);
} catch (e) {
// Failed to get child at point.
}
info("could not get child at point");
return null;
}
async function testChildAtPoint(dpr, x, y, container, child, grandChild) {
const [containerX, containerY] = Layout.getBounds(container, dpr);
x += containerX;
y += containerY;
let actual = null;
await untilCacheIs(
() => {
actual = getChildAtPoint(container, x, y, false);
info(`Got direct child match of ${CommonUtils.prettyName(actual)}`);
return actual;
},
child,
`Wrong direct child accessible at the point (${x}, ${y}) of ${CommonUtils.prettyName(
container
)}, sought ${CommonUtils.prettyName(
child
)} and got ${CommonUtils.prettyName(actual)}`
);
actual = null;
await untilCacheIs(
() => {
actual = getChildAtPoint(container, x, y, true);
info(`Got deepest child match of ${CommonUtils.prettyName(actual)}`);
return actual;
},
grandChild,
`Wrong deepest child accessible at the point (${x}, ${y}) of ${CommonUtils.prettyName(
container
)}, sought ${CommonUtils.prettyName(
grandChild
)} and got ${CommonUtils.prettyName(actual)}`
);
}
/**
* Test if getChildAtPoint returns the given child and grand child accessibles
* at coordinates of child accessible (direct and deep hit test).
*/
async function hitTest(browser, container, child, grandChild) {
let domEl = getAccessibleDOMNodeID(child);
if (!domEl) {
// It is possible this accessible has died, but it is also
// possible we are dealing with an accessible constructed
// from a pseudoelement, like ::details-content
if (child.parent.role == ROLE_DETAILS) {
// In the ::details-content case, attempt to use the
// inner content to construct our hittesting point.
domEl = getAccessibleDOMNodeID(child.firstChild);
}
}
const [childX, childY] = await getContentBoundsForDOMElm(browser, domEl);
const x = childX + 1;
const y = childY + 1;
await untilCacheIs(
() => getChildAtPoint(container, x, y, false),
child,
`Wrong direct child accessible at the point (${x}, ${y}) of ${CommonUtils.prettyName(
container
)}, sought ${CommonUtils.prettyName(child)}`
);
await untilCacheIs(
() => getChildAtPoint(container, x, y, true),
grandChild,
`Wrong deepest child accessible at the point (${x}, ${y}) of ${CommonUtils.prettyName(
container
)}, sought ${CommonUtils.prettyName(grandChild)}`
);
}
/**
* Test if getOffsetAtPoint returns the given text offset at given coordinates.
*/
async function testOffsetAtPoint(hyperText, x, y, coordType, expectedOffset) {
await untilCacheIs(
() => hyperText.getOffsetAtPoint(x, y, coordType),
expectedOffset,
`Wrong offset at given point (${x}, ${y}) for ${prettyName(hyperText)}`
);
}