Implements https://w3c.github.io/accname/. 

Implements https://w3c.github.io/accname/

eps1lon

dom-accessibility-api

exports.computeTextAlternative = computeTextAlternative;

var _array = _interopRequireDefault(require("./polyfills/array.from"));

var _SetLike = _interopRequireDefault(require("./polyfills/SetLike"));

function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

 * implements https://w3c.github.io/accname/

  return s.trim().replace(/\s\s+/g, " ");

 * @param options - These are not optional to prevent accidentally calling it without options in `computeAccessibleName`

function isHidden(node, getComputedStyleImplementation) {

  if (node.hasAttribute("hidden") || node.getAttribute("aria-hidden") === "true") {

  var style = getComputedStyleImplementation(node);

  return style.getPropertyValue("display") === "none" || style.getPropertyValue("visibility") === "hidden";

 * @returns {boolean} - As defined in step 2E of https://w3c.github.io/accname/#mapping_additional_nd_te

  return (0, _util.hasAnyConcreteRoles)(node, ["button", "combobox", "listbox", "textbox"]) || hasAbstractRole(node, "range");

      return (0, _util.hasAnyConcreteRoles)(node, ["meter", "progressbar", "scrollbar", "slider", "spinbutton"]);

      throw new TypeError("No knowledge about abstract role '".concat(role, "'. This is likely a bug :("));

 * element.querySelectorAll but also considers owned tree

function querySelectorAllSubtree(element, selectors) {

  var elements = (0, _array.default)(element.querySelectorAll(selectors));

  (0, _util.queryIdRefs)(element, "aria-owns").forEach(function (root) {

    // babel transpiles this assuming an iterator

    elements.push.apply(elements, (0, _array.default)(root.querySelectorAll(selectors)));

  if ((0, _util.isHTMLSelectElement)(listbox)) {

    return listbox.selectedOptions || querySelectorAllSubtree(listbox, "[selected]");

  return querySelectorAllSubtree(listbox, '[aria-selected="true"]');

  return (0, _util.hasAnyConcreteRoles)(node, ["none", "presentation"]);

 * Elements specifically listed in html-aam

 * We don't need this for `label` or `legend` elements.

 * Their implicit roles already allow "naming from content".

 * - https://w3c.github.io/html-aam/#table-element

function isNativeHostLanguageTextAlternativeElement(node) {

  return (0, _util.isHTMLTableCaptionElement)(node);

 * https://w3c.github.io/aria/#namefromcontent

  return (0, _util.hasAnyConcreteRoles)(node, ["button", "cell", "checkbox", "columnheader", "gridcell", "heading", "label", "legend", "link", "menuitem", "menuitemcheckbox", "menuitemradio", "option", "radio", "row", "rowheader", "switch", "tab", "tooltip", "treeitem"]);

    var labelElements = (0, _util.queryIdRefs)(current, "aria-labelledby");

    var labelAttributeNode = (0, _util.isElement)(current) ? current.getAttributeNode("aria-labelledby") : null;

    // TODO: Do we generally need to block query IdRefs of attributes we have already consulted?

    var labelElements = labelAttributeNode !== null && !consultedNodes.has(labelAttributeNode) ? (0, _util.queryIdRefs)(current, "aria-labelledby") : [];

    if (compute === "name" && !context.isReferenced && labelElements.length > 0) {

      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- Can't be null here otherwise labelElements would be empty

      consultedNodes.add(labelAttributeNode);

      return labelElements.map(function (element) {

        // TODO: Chrome will consider repeated values i.e. use a node multiple times while we'll bail out in computeTextAlternative.

        return computeTextAlternative(element, {

          isEmbeddedInLabel: context.isEmbeddedInLabel,

          // thais isn't recursion as specified, otherwise we would skip

          // this isn't recursion as specified, otherwise we would skip

          // <input id="myself" aria-label="foo" aria-labelledby="myself"

    // Changed from the spec in anticipation of https://github.com/w3c/accname/issues/64

    // spec says we should only consider skipping if we have a non-empty label

    var skipToStep2E = context.recursion && isControl(current) && compute === "name";

      var ariaLabel = ((0, _util.isElement)(current) && current.getAttribute("aria-label") || "").trim();

      if (ariaLabel !== "" && compute === "name") {

      if (!isMarkedPresentational(current)) {

        var elementTextAlternative = computeElementTextAlternative(current);

        if (elementTextAlternative !== null) {

    // special casing, cheating to make tests pass

    // https://github.com/w3c/accname/issues/67

    if ((0, _util.hasAnyConcreteRoles)(current, ["menu"])) {

    if (skipToStep2E || context.isEmbeddedInLabel || context.isReferenced) {

      if ((0, _util.hasAnyConcreteRoles)(current, ["combobox", "listbox"])) {

        var selectedOptions = querySelectedOptions(current);

        if (selectedOptions.length === 0) {

          // defined per test `name_heading_combobox`

          return (0, _util.isHTMLInputElement)(current) ? current.value : "";

        return (0, _array.default)(selectedOptions).map(function (selectedOption) {

          return computeTextAlternative(selectedOption, {

            isEmbeddedInLabel: context.isEmbeddedInLabel,

      if (hasAbstractRole(current, "range")) {

        if (current.hasAttribute("aria-valuetext")) {

          // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- safe due to hasAttribute guard

          return current.getAttribute("aria-valuetext");

        if (current.hasAttribute("aria-valuenow")) {

          return current.getAttribute("aria-valuenow");

        // Otherwise, use the value as specified by a host language attribute.

        return current.getAttribute("value") || "";

      if ((0, _util.hasAnyConcreteRoles)(current, ["textbox"])) {

        return getValueOfTextbox(current);

    // 2F: https://w3c.github.io/accname/#step2F

    if (allowsNameFromContent(current) || (0, _util.isElement)(current) && context.isReferenced || isNativeHostLanguageTextAlternativeElement(current) || isDescendantOfNativeHostLanguageTextAlternativeElement(current)) {

      var accumulatedText2F = computeMiscTextAlternative(current, {

        isEmbeddedInLabel: context.isEmbeddedInLabel,

    if (current.nodeType === current.TEXT_NODE) {

      return computeMiscTextAlternative(current, {

    var tooltipAttributeValue = computeTooltipAttributeValue(current);

    if (tooltipAttributeValue !== null) {

	"description": "Implements https://w3c.github.io/accname/",

		"url": "https://github.com/eps1lon/dom-accessibility-api.git"

		"build": "yarn build:clean && yarn build:source && yarn build:source:cjs && yarn build:types",

		"build:source": "cross-env BABEL_ENV=esm babel sources --extensions \".ts\" --ignore \"**/__tests__/**/*\" --out-dir dist/ --out-file-extension=.mjs --source-maps",

		"build:source:cjs": "cross-env BABEL_ENV=cjs babel sources --extensions \".ts\" --ignore \"**/__tests__/**/*\" --out-dir dist/ --out-file-extension=.js --source-maps",

		"build:types": "tsc -p tsconfig.json --emitDeclarationOnly",

		"format": "prettier \"**/*.{json,js,md,ts,yml}\" --write --ignore-path .prettierignore",

		"lint": "eslint --report-unused-disable-directives \"{scripts,sources}/**/*.{js,ts}\"",

		"release": "yarn build && yarn changeset publish",

		"test": "jest --config scripts/jest/jest.config.js",

		"test:ci": "jest --ci --config scripts/jest/jest.ci.config.js --runInBand",

		"test:coverage": "jest --config scripts/jest/jest.coverage.config.js",

		"test:types": "tsc -p tsconfig.json --noEmit",

		"test:wpt:jsdom": "mocha tests/wpt-jsdom/run-wpts.js",

		"test:wpt:browser": "concurrently --success first --kill-others \"yarn test:wpt:browser:run\" \"yarn test:wpt:browser:server\"",

		"test:wpt:browser:run": "cypress run --project tests",

		"test:wpt:browser:server": "serve tests/wpt",

		"test:wpt:browser:open": "cypress open --project tests",

		"wpt:init": "git submodule update --init --recursive",

		"wpt:reset": "rimraf ./tests/wpt && yarn wpt:init",

		"wpt:update": "git submodule update --recursive --remote && cd tests/wpt && python wpt.py manifest --path ../wpt-jsdom/wpt-manifest.json"

		"@babel/plugin-proposal-class-properties": "^7.13.0",

		"@changesets/changelog-github": "^0.4.0",

		"@typescript-eslint/eslint-plugin": "^5.0.0",

		{
		"name": "dom-accessibility-api",
		"description": "Implements https://w3c.github.io/accname/",
		"version": "0.5.15",
		"version": "0.5.16",
		"main": "dist/index.js",
		@@ -66,3 +66,3 @@ "module": "dist/index.mjs",
		"jsdom": "^20.0.0",
		"minimatch": "^5.0.0",
		"minimatch": "^6.0.0",
		"mocha": "^10.0.0",
		@@ -74,3 +74,3 @@ "mocha-sugar-free": "^1.4.0",
		"request-promise-native": "^1.0.9",
		"rimraf": "^3.0.2",
		"rimraf": "^4.0.0",
		"serve": "^14.0.0",
		@@ -77,0 +77,0 @@ "typescript": "^4.3.2"

		@@ -412,9 +412,14 @@ "use strict";
		// 2B
		var labelElements = (0, _util.queryIdRefs)(current, "aria-labelledby");
		var labelAttributeNode = (0, _util.isElement)(current) ? current.getAttributeNode("aria-labelledby") : null;
		// TODO: Do we generally need to block query IdRefs of attributes we have already consulted?
		var labelElements = labelAttributeNode !== null && !consultedNodes.has(labelAttributeNode) ? (0, _util.queryIdRefs)(current, "aria-labelledby") : [];
		if (compute === "name" && !context.isReferenced && labelElements.length > 0) {
		// eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- Can't be null here otherwise labelElements would be empty
		consultedNodes.add(labelAttributeNode);
		return labelElements.map(function (element) {
		// TODO: Chrome will consider repeated values i.e. use a node multiple times while we'll bail out in computeTextAlternative.
		return computeTextAlternative(element, {
		isEmbeddedInLabel: context.isEmbeddedInLabel,
		isReferenced: true,
		// thais isn't recursion as specified, otherwise we would skip
		// this isn't recursion as specified, otherwise we would skip
		// `aria-label` in
		@@ -421,0 +426,0 @@ // <input id="myself" aria-label="foo" aria-labelledby="myself"

Improved metrics