From 82d784405f0bf97c8d2b012b54854904b06edf20 Mon Sep 17 00:00:00 2001 From: Valerie Young Date: Mon, 11 May 2026 17:40:33 -0700 Subject: [PATCH 1/7] Get Accessibility Properties --- index.html | 132 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 132 insertions(+) diff --git a/index.html b/index.html index fbdf6133..937f83f3 100644 --- a/index.html +++ b/index.html @@ -1040,6 +1040,19 @@

Endpoints

/session/{session id}/print Print Page + + + GET + /session/{session id}/element/{element id}/accessibilityproperties + Get Accessibility Properties + + + + GET + /session/{session id}/accessibility/properties/{accessibility id} + Get Accessibility Properties For Accessible Object + + @@ -1193,6 +1206,14 @@

Errors

and cannot be brought into that viewport. + + no such accessible + 404 + no such accessible + An accessibility node could not be located on the page + using the given search parameters. + + no such alert 404 @@ -1255,6 +1276,14 @@

Errors

A new session could not be created. + + stale accessible reference + 404 + stale accessible reference + A command failed because + the referenced accessible is no available. + + stale element reference 404 @@ -6028,6 +6057,43 @@

Get Computed Label

  • Return success with data label. + +

    +

    Get Accessibility Properties

    + + + + + + + + + + +
    HTTP MethodURI Template
    GET/session/{session id}/element/{element id}/accessibilityproperties
    + +

    The remote end steps, given session, URL +variables and parameters are: + +

      +

    1. If session's current browsing context is no longer open, + return error with error code no such window. + +

    2. Try to handle any user prompts + with session. + +

    3. Let element be the result + of trying to get a known element + with URL variables["element id"]. + +

    4. Let accessible be the accessible object that corrosponds to this element in the accessibility tree. + +

    5. Let properties be the result of computing the accessibility properties of accessible. + + +

    6. Return success with data properties. +

    +
    @@ -11116,6 +11182,68 @@

    Take Element Screenshot

    +
    +

    Accessibility

    + +

    An accessibility ID is a string value representing a handle to an accessible object in a specific WebDriver session. + +

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

    +
    "accessibilityId" +
    The accessibility ID of this accessible object. + +
    "parent" +
    The accessibility ID of the parent of this accessible object in the accessibility tree, including ignored accessible objects. + +
    "children" +
    A list of accessibility IDs representing the children of this accessible object in the accessibility tree, including ignored accessible objects. +
    + +

    Ignored accessible objects are accessible objects that represent elements which are excluded from the accessibility tree. The accessibility properties of these accessible objects must only have the keys accessibilityID, parent, children and role set to "none". + +

    To get a known accessible object given session and reference: + +

      +

    1. TO DO: Should we create a parallel to the specification of get a known element? Do we need to make a parallel structure to browsing context group node map and node id map? +

    + +
    +

    Get Accessibility Properties for Accessible Object

    + + + + + + + + + + +
    HTTP MethodURI Template
    GET/session/{session id}/accessibiltiy/properties/{accessibility id}/
    + +

    The remote end steps, given session, URL +variables and parameters are: + +

      +

    1. If session's current browsing context is no longer open, + return error with error code no such window. + +

    2. Try to handle any user prompts + with session. + +

    3. Let node be the result + of trying to get a known accessible object + with URL variables["accessibility id"]. + +

    4. Let properties be the result of computing the accessibility properties of node. + +

    5. Return success with data properties. +

    + +
    +
    +

    Print

    @@ -11602,7 +11730,11 @@

    Index

    The following terms are defined in the Accessible Rich Internet Applications (WAI-ARIA) 1.2 specification: [[wai-aria-1.2]]

    From 71d6ead9f09150850a96e4e20cf7452d67166909 Mon Sep 17 00:00:00 2001 From: Valerie Young Date: Wed, 13 May 2026 15:09:59 -0700 Subject: [PATCH 2/7] Accessible object to accessibility node and other fixes --- index.html | 43 +++++++++++++++++++++---------------------- 1 file changed, 21 insertions(+), 22 deletions(-) diff --git a/index.html b/index.html index 937f83f3..ac7d6547 100644 --- a/index.html +++ b/index.html @@ -1050,7 +1050,7 @@

    Endpoints

    GET /session/{session id}/accessibility/properties/{accessibility id} - Get Accessibility Properties For Accessible Object + Get Accessibility Properties For Accessibility Node @@ -1207,10 +1207,10 @@

    Errors

    - no such accessible + no such accessible node 404 - no such accessible - An accessibility node could not be located on the page + no such accessible node + An accessibility node could not be located on the page using the given search parameters. @@ -1277,11 +1277,11 @@

    Errors

    - stale accessible reference + stale accessible node reference 404 - stale accessible reference + stale accessible node reference A command failed because - the referenced accessible is no available. + the referenced accessible node is no available. @@ -6086,7 +6086,7 @@

    Get Accessibility Properties

    of trying to get a known element with URL variables["element id"]. -

  • Let accessible be the accessible object that corrosponds to this element in the accessibility tree. +

  • Let accessible be the accessible node that corrosponds to this element in the accessibility tree.

  • Let properties be the result of computing the accessibility properties of accessible. @@ -11185,31 +11185,33 @@

    Take Element Screenshot

    Accessibility

    -

    An accessibility ID is a string value representing a handle to an accessible object in a specific WebDriver session. +

    An accessibility ID is a string value representing a handle to an accessible node in a specific WebDriver session. -

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

    An accessibility node is an node in the implementation defined internal accessibility tree. These nodes frequently but not always correlated to DOM elements. + +

    Accessibility properties is a JSON Object that contains the relevant computed accessibility properties of an accessiblity node, as well as the following properties:

    "accessibilityId" -
    The accessibility ID of this accessible object. +
    The accessibility ID of this accessible node.
    "parent" -
    The accessibility ID of the parent of this accessible object in the accessibility tree, including ignored accessible objects. +
    The accessibility ID of the parent of this accessible node in the accessibility tree, including ignored accessible nodes.
    "children" -
    A list of accessibility IDs representing the children of this accessible object in the accessibility tree, including ignored accessible objects. +
    A list of accessibility IDs representing the child nodes of this accessible node in the implementation’s internal accessibility tree
    -

    Ignored accessible objects are accessible objects that represent elements which are excluded from the accessibility tree. The accessibility properties of these accessible objects must only have the keys accessibilityID, parent, children and role set to "none". +

    Ignored accessible nodes are accessible nodes that represent elements which are excluded from the accessibility tree. The accessibility properties of these accessible nodes must only have the keys accessibilityID, parent, children and role set to "none". -

    To get a known accessible object given session and reference: +

    To get a known accessible node given session and reference:

    1. TO DO: Should we create a parallel to the specification of get a known element? Do we need to make a parallel structure to browsing context group node map and node id map?

    -

    Get Accessibility Properties for Accessible Object

    +

    Get Accessibility Properties for Accessible Node

    @@ -11233,7 +11235,7 @@

    Get Accessibility Properties for Accessible Object

    with session.

  • Let node be the result - of trying to get a known accessible object + of trying to get a known accessible node with URL variables["accessibility id"].

  • Let properties be the result of computing the accessibility properties of node. @@ -11241,7 +11243,7 @@

    Get Accessibility Properties for Accessible Object

  • Return success with data properties. - +

    @@ -11730,11 +11732,8 @@

    Index

    The following terms are defined in the Accessible Rich Internet Applications (WAI-ARIA) 1.2 specification: [[wai-aria-1.2]]

    From 1c104dfff722fa5a30ed32cd5ed43bc0636b16d6 Mon Sep 17 00:00:00 2001 From: Valerie Young Date: Wed, 3 Jun 2026 14:49:56 -0700 Subject: [PATCH 3/7] Apply suggestions from code review Co-authored-by: James Teh --- index.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index ac7d6547..99c707a3 100644 --- a/index.html +++ b/index.html @@ -1281,7 +1281,7 @@

    Errors

    • @@ -6086,7 +6086,7 @@

    Get Accessibility Properties

    of trying to get a known element with URL variables["element id"]. -

  • Let accessible be the accessible node that corrosponds to this element in the accessibility tree. +

  • Let accessible be the accessible node that corresponds to this element in the accessibility tree.

  • Let properties be the result of computing the accessibility properties of accessible. @@ -11187,7 +11187,7 @@

    Accessibility

    An accessibility ID is a string value representing a handle to an accessible node in a specific WebDriver session. -

    An accessibility node is an node in the implementation defined internal accessibility tree. These nodes frequently but not always correlated to DOM elements. +

    An accessibility node is a node in the implementation defined internal accessibility tree. These nodes frequently but not always correlated to DOM elements.

    Accessibility properties is a JSON Object that contains the relevant computed accessibility properties of an accessiblity node, as well as the following properties: @@ -11733,7 +11733,7 @@

    Index

    in the Accessible Rich Internet Applications (WAI-ARIA) 1.2 specification: [[wai-aria-1.2]]
    From f02fdbda09571e0195ea6c7ed3102091b5aa48af Mon Sep 17 00:00:00 2001 From: Valerie Young Date: Wed, 3 Jun 2026 16:43:47 -0700 Subject: [PATCH 4/7] Update based on convos --- index.html | 56 +++++++++++++++++++++++------------------------------- 1 file changed, 24 insertions(+), 32 deletions(-) diff --git a/index.html b/index.html index 99c707a3..e1620d4a 100644 --- a/index.html +++ b/index.html @@ -1207,9 +1207,9 @@

    Errors

    • - @@ -1276,14 +1276,6 @@

    Errors

    - - -
    404 stale accessible node reference A command failed because - the referenced accessible node is no available. + the referenced accessible node is no longer available.
    no such accessible node + no such accessibility node 404 - no such accessible node + no such accessibility node An accessibility node could not be located on the page using the given search parameters.
    A new session could not be created.
    stale accessible node reference - 404 - stale accessible node reference - A command failed because - the referenced accessible node is no longer available. -
    stale element reference 404 @@ -6086,11 +6078,10 @@

    Get Accessibility Properties

    of trying to get a known element with URL variables["element id"]. -

  • Let accessible be the accessible node that corresponds to this element in the accessibility tree. +

  • Let accessible be the accessibility node that corresponds to this element. If no accessibility node exists, return error with error code no such accessibility node.

  • Let properties be the result of computing the accessibility properties of accessible. -

  • Return success with data properties. @@ -11185,33 +11176,25 @@

    Take Element Screenshot

    Accessibility

    -

    An accessibility ID is a string value representing a handle to an accessible node in a specific WebDriver session. +

    An accessibility ID is a string value representing a handle to an accessibility node in a specific WebDriver session. -

    An accessibility node is a node in the implementation defined internal accessibility tree. These nodes frequently but not always correlated to DOM elements. +

    An accessibility node is a platform-independent, implementation-defined node in the platform-independent, implementation-defined accessibility tree. The platform-independent, implementation defined accessibility tree is built from the DOM tree for the purposes of interacting with the web page via an accessibility API. Accessibility nodes might exist in this tree for which there is no DOM element back it (for example, one might be create to represent a CSS pseudo element). Additionally, an accessibility node might not be created for every DOM node (for example, if something is intentionally hidden from accessibility APIs using aria-hidden). See the ARIA definition of the accessibility tree for more information. -

    Accessibility properties is a JSON Object that contains the relevant computed accessibility properties of an accessiblity node, as well as the following properties: +

    Accessibility properties is a JSON Object that contains the relevant computed accessibility properties of an accessibility node, as well as the following properties:

    "accessibilityId" -
    The accessibility ID of this accessible node. +
    The accessibility ID of this accessibility node.
    "parent" -
    The accessibility ID of the parent of this accessible node in the accessibility tree, including ignored accessible nodes. +
    The accessibility ID of the parent of this accessibility node in the accessibility tree.
    "children" -
    A list of accessibility IDs representing the child nodes of this accessible node in the implementation’s internal accessibility tree +
    A list of accessibility IDs representing the child nodes of this accessibility node in the accessibility tree.
    -

    Ignored accessible nodes are accessible nodes that represent elements which are excluded from the accessibility tree. The accessibility properties of these accessible nodes must only have the keys accessibilityID, parent, children and role set to "none". - -

    To get a known accessible node given session and reference: - -

      -

    1. TO DO: Should we create a parallel to the specification of get a known element? Do we need to make a parallel structure to browsing context group node map and node id map? -

    -
    -

    Get Accessibility Properties for Accessible Node

    +

    Get Accessibility Properties for Accessibility Node

    @@ -11234,16 +11217,14 @@

    Get Accessibility Properties for Accessible Node

  • Try to handle any user prompts with session. -

  • Let node be the result - of trying to get a known accessible node - with URL variables["accessibility id"]. +

  • Let node be the accessibility node with accessibility ID matching the URL variables["accessibility id"]. If no such accessibility node exists, return error with error code no such accessibility node.

  • Let properties be the result of computing the accessibility properties of node.

  • Return success with data properties. - +

    @@ -11733,7 +11714,10 @@

    Index

    in the Accessible Rich Internet Applications (WAI-ARIA) 1.2 specification: [[wai-aria-1.2]]
    @@ -11745,6 +11729,14 @@

    Index

    Name and Description Computation +
    +

    The following terms are defined + in the Core Accessibility API Mappings (Core-AAM) 1.2 specification: [[core-aam-1.2]] +

    + +
    Web App Security

    The following terms are defined in the Content Security Policy Level 3 specification: [[CSP3]] From 174fccf6cf6e9071149e17b58aa70d54f7176b82 Mon Sep 17 00:00:00 2001 From: Valerie Young Date: Thu, 4 Jun 2026 08:34:30 -0700 Subject: [PATCH 5/7] Apply suggestion from @jcsteh Co-authored-by: James Teh --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index e1620d4a..5f6f0ca5 100644 --- a/index.html +++ b/index.html @@ -11178,7 +11178,7 @@

    Accessibility

    An accessibility ID is a string value representing a handle to an accessibility node in a specific WebDriver session. -

    An accessibility node is a platform-independent, implementation-defined node in the platform-independent, implementation-defined accessibility tree. The platform-independent, implementation defined accessibility tree is built from the DOM tree for the purposes of interacting with the web page via an accessibility API. Accessibility nodes might exist in this tree for which there is no DOM element back it (for example, one might be create to represent a CSS pseudo element). Additionally, an accessibility node might not be created for every DOM node (for example, if something is intentionally hidden from accessibility APIs using aria-hidden). See the ARIA definition of the accessibility tree for more information. +

    An accessibility node is a platform-independent, implementation-defined node in the platform-independent, implementation-defined accessibility tree. The platform-independent, implementation defined accessibility tree is built from the DOM tree for the purposes of interacting with the web page via an accessibility API. Accessibility nodes might exist in this tree for which there is no DOM element back it (for example, one might be created to represent a CSS pseudo element). Additionally, an accessibility node might not be created for every DOM node (for example, if something is intentionally hidden from accessibility APIs using aria-hidden). See the ARIA definition of the accessibility tree for more information.

    Accessibility properties is a JSON Object that contains the relevant computed accessibility properties of an accessibility node, as well as the following properties: From 55e15b36eb0dcaf6f7ec2df385eb80ac496b7703 Mon Sep 17 00:00:00 2001 From: Valerie Young Date: Thu, 4 Jun 2026 15:42:18 -0700 Subject: [PATCH 6/7] Update route name --- index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 5f6f0ca5..d58fde47 100644 --- a/index.html +++ b/index.html @@ -1044,7 +1044,7 @@

    Endpoints

    • - + @@ -6051,7 +6051,7 @@

    Get Computed Label

    -

    Get Accessibility Properties

    +

    Get Accessibility Properties For Element

    GET /session/{session id}/element/{element id}/accessibilitypropertiesGet Accessibility PropertiesGet Accessibility Properties For Element
    From 24d7021df5eeb06547e8f90d4acd919acd95bf78 Mon Sep 17 00:00:00 2001 From: Valerie Young Date: Tue, 9 Jun 2026 17:26:49 -0700 Subject: [PATCH 7/7] Use accessibility node id --- index.html | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/index.html b/index.html index d58fde47..54fb5227 100644 --- a/index.html +++ b/index.html @@ -11176,7 +11176,7 @@

    Take Element Screenshot

    Accessibility

    -

    An accessibility ID is a string value representing a handle to an accessibility node in a specific WebDriver session. +

    An accessibility node ID is a string value representing a handle to an accessibility node in a specific WebDriver session.

    An accessibility node is a platform-independent, implementation-defined node in the platform-independent, implementation-defined accessibility tree. The platform-independent, implementation defined accessibility tree is built from the DOM tree for the purposes of interacting with the web page via an accessibility API. Accessibility nodes might exist in this tree for which there is no DOM element back it (for example, one might be created to represent a CSS pseudo element). Additionally, an accessibility node might not be created for every DOM node (for example, if something is intentionally hidden from accessibility APIs using aria-hidden). See the ARIA definition of the accessibility tree for more information. @@ -11184,13 +11184,13 @@

    Accessibility

    "accessibilityId" -
    The accessibility ID of this accessibility node. +
    The accessibility node ID of this accessibility node.
    "parent" -
    The accessibility ID of the parent of this accessibility node in the accessibility tree. +
    The accessibility node ID of the parent of this accessibility node in the accessibility tree.
    "children" -
    A list of accessibility IDs representing the child nodes of this accessibility node in the accessibility tree. +
    A list of accessibility node IDs representing the child nodes of this accessibility node in the accessibility tree.
    @@ -11217,7 +11217,7 @@

    Get Accessibility Properties for Accessibility Node

  • Try to handle any user prompts with session. -

  • Let node be the accessibility node with accessibility ID matching the URL variables["accessibility id"]. If no such accessibility node exists, return error with error code no such accessibility node. +

  • Let node be the accessibility node with accessibility node ID matching the URL variables["accessibility id"]. If no such accessibility node exists, return error with error code no such accessibility node.

  • Let properties be the result of computing the accessibility properties of node.