Struct AXTree 

pub struct AXTree {
    pub nodes: HashMap<String, AXNode>,
    pub root_id: Option<String>,
    /* private fields */
}

The complete Accessibility Tree for a page

Fields

nodes: HashMap<String, AXNode>

All nodes in the tree, indexed by node_id

root_id: Option<String>

The root node ID

Implementations

impl AXTree

pub fn new() -> AXTree

Create a new empty AXTree

pub fn from_nodes(nodes: Vec<AXNode>) -> AXTree

Build tree from a list of nodes

pub fn get_node(&self, node_id: &str) -> Option<&AXNode>

Get a node by ID

pub fn node_by_backend_id(&self, backend_id: i64) -> Option<&AXNode>

Den Knoten zu einer Backend-Node-ID finden.

Die Backend-ID zeigt auf den DOM-Knoten und bleibt über mehrere getFullAXTree-Aufrufe stabil, anders als node_id. Sie ist deshalb der Schlüssel, mit dem der Journey-Layer ein Element wiederfindet, das er selbst bedient hat.

pub fn is_within(&self, backend_id: i64, ancestor_backend_id: i64) -> bool

Ob backend_id im Baum unterhalb von ancestor_backend_id liegt (oder dieser Knoten selbst ist).

Beantwortet „steht der Fokus innerhalb des Dialogs?“ am Accessibility-Tree statt an element.contains() im DOM — und damit auch über Shadow Roots hinweg, die querySelector nicht durchdringt.

pub fn root(&self) -> Option<&AXNode>

Get the root node

pub fn iter(&self) -> impl Iterator<Item = &AXNode>

Iterate over all auditable nodes (excludes browser-generated artifacts). This is the default iterator that all WCAG rules should use.

Also excluded: everything below a Video or Audio node. With controls, Chrome exposes the player’s own interface there — play, mute and fullscreen buttons, a timeline slider without valuenow — from the browser’s shadow DOM. No author wrote it or can fix it, and ARIA rules reported the timeline as a Critical “missing aria-valuenow” on every page with a <video controls>. Fallback content inside <video> is only rendered where video is unsupported, so the subtree is never author content. The media node itself stays.

pub fn iter_all(&self) -> impl Iterator<Item = &AXNode>

Iterate over ALL nodes including browser-generated artifacts. Only use this for tree traversal, parent/child lookups, or non-WCAG analysis.

pub fn text_nodes(&self) -> impl Iterator<Item = &AXNode>

The page’s visible text, each run counted once.

Chrome puts a text run’s characters on a StaticText node and repeats them on that node’s InlineTextBox children, one per line box. The accessible name of a heading or a link is computed from the same StaticText descendants. So the page’s text has to be read from StaticText and nowhere else, or it is counted two or three times.

Measured on two cached trees (plan 50): of all characters carried in a name, 72-76 % sit on browser-generated roles; StaticText and InlineTextBox hold near-identical totals spread over different node counts; 30 of 44 heading names and 71 of 87 link names repeat a StaticText verbatim. paragraph nodes exist but never carry a name of their own, so a role filter naming paragraph matches nothing.

iter excludes all of this deliberately — a WCAG rule must not report a finding against a node the author never wrote. Anything measuring text wants this instead.

pub fn visible_text_len(&self) -> usize

Total length of the page’s visible text. See text_nodes.

pub fn nodes_with_role(&self, role: &str) -> Vec<&AXNode>

Get all nodes with a specific role (excludes browser-generated nodes)

pub fn images(&self) -> Vec<&AXNode>

Get all image nodes

pub fn headings(&self) -> Vec<&AXNode>

Get all heading nodes

pub fn form_controls(&self) -> Vec<&AXNode>

Get all form control nodes (excluding buttons, which are checked separately)

pub fn links(&self) -> Vec<&AXNode>

Get all link nodes

pub fn len(&self) -> usize

Count total nodes

pub fn is_empty(&self) -> bool

Check if tree is empty

Trait Implementations

impl Clone for AXTree

fn clone(&self) -> AXTree

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AXTree

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for AXTree

fn default() -> AXTree

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AXTree

fn deserialize<__D>( __deserializer: __D, ) -> Result<AXTree, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AXTree

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.