Get Accessibility Properties by spectranaut · Pull Request #1960 · w3c/webdriver

spectranaut · 2026-05-12T00:44:08Z

Added/update sections:

To dos:

Definition of get a known accessible object could parallel get a know element. That is a long, branch algorithm, that will mean adding new parallel errors, and maybe even data structures. Should it eventually hook into existing data structures, like https://pr-preview.s3.amazonaws.com/Igalia/webdriver/pull/1960.html#dfn-node-id-map, or should it forever be separate?
- Some discussion of ids in comment on the Explainer.
Probably the algorithm for Element's Get Computed Properties is too vague about how to get the accessibility node.
Error handling
- Discussion on errors in explainer
Maybe expand on definition of accessibility id
- Discussion on IDs in the explainer

This change is

cookiecrook · 2026-05-21T17:16:26Z

+ <tr>
+  <td><dfn>no such accessible</dfn>
+  <td>404
+  <td><code>no such accessible</code>


Unless we’re trying to match existing precedent for this “no such” phrasing, I’d prefer:

Suggested change

<td><code>no such accessible</code>

<td><code>accessible node not found</code>

Or if people really want to keep the precedent, let’s call it “no such accessible node” rather than “no such accessible”

cookiecrook · 2026-05-21T17:18:13Z

+ <tr>
+  <td><dfn>stale accessible reference</dfn>
+  <td>404
+  <td><code>stale accessible reference</code>


Do we have confidence that the implementations will retain the difference between “was here but is now stale” and “not found for some other reason”? If not, the first 404 may suffice.

cookiecrook · 2026-05-21T17:24:05Z

+
+<p> An <dfn>accessibility ID</dfn> is a string value representing a handle to an <a>accessible object</a> in a specific WebDriver session.
+
+<p> <dfn>Accessibility properties</dfn> is a JSON <a>Object</a> that contains the relevant <a>WAI-ARIA states and properties</a> of an <a>accessible object</a>, as well as the following properties:


Not to downgrade ARIA, but it’s a subset here:

Suggested change

<p> <dfn>Accessibility properties</dfn> is a JSON <a>Object</a> that contains the relevant <a>WAI-ARIA states and properties</a> of an <a>accessible object</a>, as well as the following properties:

<p> <dfn>Accessibility properties</dfn> is a JSON <a>Object</a> that contains the relevant <a>accessibility properties</a> of an <a>accessible object</a>, as well as the following properties:

cookiecrook · 2026-05-21T17:24:45Z

+
+  <dl>
+   <dt>"<code>accessibilityId</code>"
+   <dd>The <a>accessibility ID</a> of this <a>accessible object</a>.


Object or node?

cookiecrook · 2026-05-21T17:28:10Z

+   <dd>The <a>accessibility ID</a> of the parent of this <a>accessible object</a> in the <a>accessibility tree</a>, including <a>ignored accessible objects</a>.
+
+   <dt>"<code>children</code>"
+   <dd>A list of <a>accessibility IDs</a> representing the children of this <a>accessible object</a> in the <a>accessibility tree</a>, including <a>ignored accessible objects</a>.


Suggested change

<dd>A list of <a>accessibility IDs</a> representing the children of this <a>accessible object</a> in the <a>accessibility tree</a>, including <a>ignored accessible objects</a>.

<dd>A list of <a>accessibility IDs</a> representing the child nodes of this <a>accessible node</a> in the implementation’s <a>accessibility tree</a>.

cookiecrook · 2026-05-21T17:31:06Z

+   <dd>A list of <a>accessibility IDs</a> representing the children of this <a>accessible object</a> in the <a>accessibility tree</a>, including <a>ignored accessible objects</a>.
+  </dl>
+
+<p> <dfn>Ignored accessible objects</dfn> are accessible objects that represent <a>elements which are excluded from the accessibility tree</a>. The <a>accessibility properties</a> of these <a>accessible objects</a> must only have the keys <va>accessibilityID</var>, <va>parent</var>, <va>children</var> and <va>role</var> set to <code>"none"</code>.


Ignored accessible children may not be implementable as written. The “ignored” state is usually on the non-accessibility rendered object which can—module implementation details—result in no backing accessibility node to return in the child list.

cookiecrook · 2026-05-21T17:32:37Z

+<p>To <dfn>get a known accessible object</dfn> given <var>session</var> and <var>reference</var>:
+
+<ol class="algorithm">
+  <li><p>TO DO: Should we create a parallel to the specification of <a>get a known element</a>? Do we need to make a parallel structure to <a>browsing context group node map</a> and <a>node id map</a>?


I don’t think we need it, unless the element ID can’t be returned in the property bag.

cookiecrook · 2026-05-21T17:34:01Z

+</ol>
+
+<section>
+<h3><dfn>Get Accessibility Properties for Accessible Object</dfn></h3>


Node not Object, right?

cookiecrook · 2026-05-21T17:35:05Z

   <p>The following terms are defined
     in the Accessible Rich Internet Applications (WAI-ARIA) 1.2 specification: [[wai-aria-1.2]]
     <ul>
+       <li><dfn><a href="https://w3c.github.io/aria/#dfn-accessible-object"></a>accessible object</dfn>


Ditto node?

Maybe we should sync an ARIA edit with this PR?

cookiecrook · 2026-05-21T17:37:29Z

+       <li><dfn><a href="https://w3c.github.io/aria/#accessibility_tree">accessibility tree</a></dfn>
+       <li><dfn><a href="https://w3c.github.io/aria/#tree_exclusion">elements which are excluded from the accessibility tree</a></dfn>
       <li><dfn><a href="https://w3c.github.io/aria/#introroles">WAI-ARIA role</a></dfn>
+       <li><dfn><a href="https://w3c.github.io/aria/#introstates">WAI-ARIA states and properties</a></dfn>


We’ll need a landing spot for the new “accessibility properties” ref above because this ARIA list is a subset.

Get Accessibility Properties

82d7844

cookiecrook reviewed May 21, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Get Accessibility Properties#1960

Get Accessibility Properties#1960
spectranaut wants to merge 1 commit into
w3c:masterfrom
Igalia:accessibility-properties

spectranaut commented May 12, 2026 •

edited by pr-preview Bot

Loading

Uh oh!

cookiecrook May 21, 2026

Uh oh!

cookiecrook May 21, 2026

Uh oh!

cookiecrook May 21, 2026

Uh oh!

cookiecrook May 21, 2026

Uh oh!

cookiecrook May 21, 2026

Uh oh!

cookiecrook May 21, 2026

Uh oh!

cookiecrook May 21, 2026

Uh oh!

cookiecrook May 21, 2026

Uh oh!

cookiecrook May 21, 2026

Uh oh!

cookiecrook May 21, 2026

Uh oh!

cookiecrook May 21, 2026

Uh oh!

cookiecrook May 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	<td><code>no such accessible</code>
	<td><code>accessible node not found</code>


		<p> An <dfn>accessibility ID</dfn> is a string value representing a handle to an <a>accessible object</a> in a specific WebDriver session.

		<p> <dfn>Accessibility properties</dfn> is a JSON <a>Object</a> that contains the relevant <a>WAI-ARIA states and properties</a> of an <a>accessible object</a>, as well as the following properties:

	<dd>A list of <a>accessibility IDs</a> representing the children of this <a>accessible object</a> in the <a>accessibility tree</a>, including <a>ignored accessible objects</a>.
	<dd>A list of <a>accessibility IDs</a> representing the child nodes of this <a>accessible node</a> in the implementation’s <a>accessibility tree</a>.

Conversation

spectranaut commented May 12, 2026 • edited by pr-preview Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

spectranaut commented May 12, 2026 •

edited by pr-preview Bot

Loading