Module tree

Expand description

Numbered accessibility tree text, diff, and the pure helpers the AX walker uses.

Nothing in this module calls a platform API. The macOS walker fills UiNode and the tests build the same nodes by hand.

Structs§

AttributeMap: Fake AXManualAccessibility / AXEnhancedUserInterface map.
BoundElement: Element index bound to one process, window, and structural revision.
ElectronEdit: What to write on attach, and what to write back on teardown.
FlagState: Previous accessibility flags for AXManualAccessibility and AXEnhancedUserInterface.
NodeFrame: Screen rectangle in points.
Rendered: Text plus the signature tree used for the next diff.
SavedFrame: Frame stored for revalidation. Points are rounded the same way the text is.
SigNode: Structural signature stored in the session cache. Values are already redacted.
TreeQuery: Request shared by tree and get-state.
TreeReport: Observation returned to the dispatcher.
UiNode: One accessibility node before numbering.

CHILD_CAP: Children kept under one parent. Further children become … +N.
DEPTH_CAP: Deepest indented level. The window is depth 0.
LINE_CAP: Rendered lines before the tree stops. truncated=true is an extra line.
URL_PATH_CAP: Maximum characters kept from a URL path.
VALUE_CAP: Maximum characters kept in a displayed value.

bundle_matches_parent: Whether child_bundle looks like a helper of parent_name / parent_bundle.
choose_text: Full text when there is no baseline or force_full is set. Otherwise the diff.
diff_trees: Diff current against previous with an LCS on (role, identity, child_count).
electron_enable: Enable the two Electron attributes when they are false or missing.
electron_restore: Values to write back. None means that attribute was not changed.
find_sig: Lookup by the index stored when the signature was rendered.
find_ui: Preorder lookup. Index 0 is root, matching render.
hosted_helper_pids: Helper pids to walk under a window.
identity_text: Identifier, otherwise title, otherwise description. Empty when all are missing.
node_is_secure: AXSecureTextField, or a subrole containing Secure.
render: Render root with the tree-text rules.
revision_of: Stable hash of the structural signatures.
shorten_url: Keep scheme, host, and at most 60 characters of the path. Drop the query.