U
|
[ ±d¸V ã @ sä d dl mZ ddlmZmZ d dlmZ d dlZd dlZddl m
|
Z
|
ddl m Z ddl m Z G d d
|
d
|
e ZG d d d ejZG d d dejZG dd dejZeG dd dZeG dd dZeG dd dZeG dd dZG dd dejZeG dd d Zd d d d Zd d d!d"ZdDd#d$d%d&d'd(d)d*ZdEd+d,d'd-d.d/Z dFd,d0d1d2d3Z dGd#d$d%d'd4d5d6Z dHd
|
d,d'd7d8d9Z dId#d$d%d:d:d'd;d<d=Z ed>eG d?d@ d@Z!edAeG dBdC dCZ"dS )Jé )Ú annotationsé )Ú event_classÚ T_JSON_DICT)Ú dataclassN)Údom)Úpage)Úruntimec sB e Zd ZdZddddZedd dddZ fd d
|
Z ZS ) ÚAXNodeIdz/
|
Unique accessibility node identifier.
|
Ústr©Úreturnc C s | S ©N© ©Úselfr r úld:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\selenium/webdriver/common/devtools/v112/accessibility.pyÚto_json s zAXNodeId.to_json©Újsonr c C s | |S r r ©Úclsr r r r Ú from_json s zAXNodeId.from_jsonc s d t ¡ ¡S )Nz AXNodeId({}))ÚformatÚsuperÚ__repr__r ©Ú __class__r r r s zAXNodeId.__repr__) Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__r Ú classmethodr r Ú __classcell__r r r r r
|
s
|
r
|
c @ sh e Zd ZdZdZdZdZdZdZdZ dZ
|
d Z d
|
Z d Z d Zd ZdZdZdZdZdZdd Zedd ZdS )Ú AXValueTypez*
|
Enum of possible property types.
|
ÚbooleanZtristateZbooleanOrUndefinedÚidrefZ idrefListÚintegerÚnodeZnodeListÚnumberÚstringZcomputedStringÚtokenZ tokenListZ domRelationÚroleZ internalRoleZvalueUndefinedc C s | j S r ©Úvaluer r r r r 6 s zAXValueType.to_jsonc C s | |S r r r r r r r 9 s zAXValueType.from_jsonN)r r r r! ÚBOOLEANZTRISTATEZBOOLEAN_OR_UNDEFINEDZIDREFZ
|
IDREF_LISTZINTEGERZNODEZ NODE_LISTÚNUMBERÚSTRINGZCOMPUTED_STRINGZTOKENZ
|
TOKEN_LISTZ DOM_RELATIONZROLEZ INTERNAL_ROLEZVALUE_UNDEFINEDr r" r r r r r r$ s* r$ c @ s< e Zd ZdZdZdZdZdZdZdZ dd Z
|
e d
|
d Z d S ) ÚAXValueSourceTypez,
|
Enum of possible property sources.
|
Ú attributeZimplicitÚstyleÚcontentsÚ placeholderZrelatedElementc C s | j S r r- r r r r r I s zAXValueSourceType.to_jsonc C s | |S r r r r r r r L s zAXValueSourceType.from_jsonN) r r r r! Z ATTRIBUTEZIMPLICITZSTYLEZCONTENTSZ PLACEHOLDERZRELATED_ELEMENTr r" r r r r r r2 > s r2 c @ sL e Zd ZdZdZdZdZdZdZdZ dZ
|
d Z d
|
Z d Z d d Zedd ZdS )ÚAXValueNativeSourceTypezd
|
Enum of possible native property sources (as a subtype of a particular AXValueSourceType).
|
Ú descriptionÚ
|
figcaptionÚlabelZlabelforZ labelwrappedZlegendZrubyannotationZ tablecaptionÚtitleÚotherc C s | j S r r- r r r r r ` s z AXValueNativeSourceType.to_jsonc C s | |S r r r r r r r c s z!AXValueNativeSourceType.from_jsonN)r r r r! Z DESCRIPTIONZ
|
FIGCAPTIONZLABELZLABELFORZ LABELWRAPPEDZLEGENDZRUBYANNOTATIONZ TABLECAPTIONZTITLEÚOTHERr r" r r r r r r7 Q s r7 c @ s e Zd ZU dZded< dZded< dZded< dZded < dZd
|
ed < dZ d ed < dZ
|
ded< dZ d
|
ed< dZ ded< dd Z edd ZdS )Ú AXValueSourcez5
|
A single source for a computed AX property.
|
r2 Útype_Nútyping.Optional[AXValue]r. útyping.Optional[str]r3 Úattribute_valueútyping.Optional[bool]Ú
|
supersededz(typing.Optional[AXValueNativeSourceType]Ú native_sourceÚnative_source_valueÚinvalidÚinvalid_reasonc C sÈ t }| j ¡ |d< | jd k r,| j ¡ |d< | jd k r@| j|d< | jd k rX| j ¡ |d< | jd k rl| j|d< | jd k r| j ¡ |d< | jd k r| j ¡ |d< | j d k r°| j |d< | j
|
d k rÄ| j
|
|d < |S )
|
NÚtyper. r3 ÚattributeValuerD Ú nativeSourceÚnativeSourceValuerG Ú invalidReason) Údictr? r r. r3 rB rD rE rF rG rH ©r r r r r r s&
|
|
|
|
|
|
|
|
|
|
|
|
zAXValueSource.to_jsonc C sÌ | t |d ¡d|kr$t |d ¡nd d|kr:t|d nd d|krRt |d ¡nd d|krht|d nd d|krt |d ¡nd d|krt |d ¡nd d|kr®t|d nd d |krÄt|d nd d
|
S ) NrI r. r3 rJ rD rK rL rG rM ) r? r. r3 rB rD rE rF rG rH )r2 r ÚAXValuer Úboolr7 r r r r r s ÷zAXValueSource.from_json)r r r r! Ú__annotations__r. r3 rB rD rE rF rG rH r r" r r r r r r> h s
|
r> c @ sB e Zd ZU ded< dZded< dZded< dd Zed d
|
ZdS ) Ú AXRelatedNodezdom.BackendNodeIdÚbackend_dom_node_idNrA r& Útextc C s@ t }| j ¡ |d< | jd k r(| j|d< | jd k r<| j|d< |S )NÚbackendDOMNodeIdr& rU )rN rT r r& rU rO r r r r · s
|
|
|
|
zAXRelatedNode.to_jsonc C sB | t j |d ¡d|kr$t|d nd d|kr:t|d nd dS )NrV r& rU )rT r& rU )r Ú BackendNodeIdr r r r r r r À s
|
ýzAXRelatedNode.from_json) r r r rR r& rU r r" r r r r r rS ¬ s
|
rS c @ s2 e Zd ZU ded< ded< dd Zedd Zd S )
|
Ú
|
AXPropertyÚAXPropertyNameÚnamerP r. c C s& t }| j ¡ |d< | j ¡ |d< |S )NrZ r. )rN rZ r r. rO r r r r Ñ s zAXProperty.to_jsonc C s | t |d ¡t |d ¡dS )NrZ r. )rZ r. )rY r rP r r r r r × s þzAXProperty.from_jsonN)r r r rR r r" r r r r r rX É s
|
|
rX c @ sR e Zd ZU dZded< dZded< dZded< dZd ed
|
< d d Ze d d Z
|
dS )rP z(
|
A single computed AX property.
|
r$ r? Nztyping.Optional[typing.Any]r. z+typing.Optional[typing.List[AXRelatedNode]]Ú related_nodesz+typing.Optional[typing.List[AXValueSource]]Úsourcesc C sh t }| j ¡ |d< | jd k r(| j|d< | jd k rFdd | jD |d< | jd k rddd | jD |d< |S )NrI r. c S s g | ] }| ¡ qS r ©r ©Ú.0Úir r r Ú
|
<listcomp>ö s z#AXValue.to_json.<locals>.<listcomp>Ú relatedNodesc S s g | ] }| ¡ qS r r] r^ r r r ra ø s r\ )rN r? r r. r[ r\ rO r r r r ð s
|
|
|
|
zAXValue.to_jsonc C s^ | t |d ¡d|kr |d nd d|kr:dd |d D nd d|krVdd |d D nd dS ) NrI r. rb c S s g | ]}t |¡qS r )rS r r^ r r r ra s z%AXValue.from_json.<locals>.<listcomp>r\ c S s g | ]}t |¡qS r )r> r r^ r r r ra s )r? r. r[ r\ )r$ r r r r r r û s üzAXValue.from_json) r r r r! rR r. r[ r\ r r" r r r r r rP ß s
|
rP c @ sÀ e Zd ZdZdZdZdZdZdZdZ dZ
|
d Z d
|
Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Z!d Z"d!Z#d"Z$d#Z%d$Z&d%Z'd&Z(d'Z)d(Z*d)d* Z+e,d+d, Z-d-S ).rY aµ
|
Values of AXProperty name:
|
- from 'busy' to 'roledescription': states which apply to every AX node
|
- from 'live' to 'root': attributes which apply to nodes in live regions
|
- from 'autocomplete' to 'valuetext': attributes which apply to widgets
|
- from 'checked' to 'selected': states which apply to widgets
|
- from 'activedescendant' to 'owns' - relationships between elements other than parent/child/sibling.
|
ÚbusyÚdisabledÚeditableZ focusableZfocusedÚhiddenZ
|
hiddenRootrG Z keyshortcutsZsettableZroledescriptionZliveZatomicZrelevantÚrootÚ autocompleteZhasPopupÚlevelZmultiselectableZ orientationÚ multilineÚreadonlyÚrequiredZvalueminZvaluemaxZ valuetextÚcheckedÚexpandedÚmodalZpressedÚselectedZactivedescendantÚcontrolsZ describedbyÚdetailsZ errormessageZflowtoZ
|
labelledbyZownsc C s | j S r r- r r r r r 6 s zAXPropertyName.to_jsonc C s | |S r r r r r r r 9 s zAXPropertyName.from_jsonN).r r r r! ZBUSYZDISABLEDZEDITABLEZ FOCUSABLEZFOCUSEDZHIDDENZ HIDDEN_ROOTÚINVALIDZ KEYSHORTCUTSZSETTABLEZROLEDESCRIPTIONZLIVEZATOMICZRELEVANTÚROOTZ AUTOCOMPLETEZ HAS_POPUPZLEVELZMULTISELECTABLEZ ORIENTATIONÚ MULTILINEZREADONLYZREQUIREDZVALUEMINZVALUEMAXZ VALUETEXTZCHECKEDZEXPANDEDZMODALZPRESSEDZSELECTEDZACTIVEDESCENDANTZCONTROLSZ DESCRIBEDBYZDETAILSZ ERRORMESSAGEZFLOWTOZ
|
LABELLEDBYZOWNSr r" r r r r r rY sV rY c @ sº e Zd ZU dZded< ded< dZded< dZd ed
|
< dZd ed < dZd ed < dZ d ed < dZ
|
d ed< dZ ded< dZ ded< dZ ded< dZded< dZded< dd Zedd ZdS ) ÚAXNodez+
|
A node in the accessibility tree.
|
r
|
Únode_idrQ ÚignoredNz(typing.Optional[typing.List[AXProperty]]Úignored_reasonsr@ r, Ú chrome_rolerZ r8 r. Ú
|
propertiesztyping.Optional[AXNodeId]Ú parent_idz&typing.Optional[typing.List[AXNodeId]]Ú child_idsú"typing.Optional[dom.BackendNodeId]rT ú typing.Optional[page.FrameId]Úframe_idc C sB t }| j ¡ |d< | j|d< | jd k r<dd | jD |d< | jd k rT| j ¡ |d< | jd k rl| j ¡ |d< | jd k r| j ¡ |d< | jd k r| j ¡ |d < | j d k r´| j ¡ |d
|
< | j
|
d k rÒd d | j
|
D |d < | j d k rê| j ¡ |d < | j d k r
|
dd | j D |d< | j d k r$| j ¡ |d< | jd k r>| j ¡ |d< |S )NÚnodeIdrx c S s g | ] }| ¡ qS r r] r^ r r r ra o s z"AXNode.to_json.<locals>.<listcomp>ÚignoredReasonsr, Ú
|
chromeRolerZ r8 r. c S s g | ] }| ¡ qS r r] r^ r r r ra { s r{ ÚparentIdc S s g | ] }| ¡ qS r r] r^ r r r ra s ÚchildIdsrV ÚframeId)rN rw r rx ry r, rz rZ r8 r. r{ r| r} rT r rO r r r r j s4
|
|
|
|
|
|
|
|
|
zAXNode.to_jsonc C s: | t |d ¡t|d d|kr2dd |d D nd d|krJt |d ¡nd d|krbt |d ¡nd d|krzt |d ¡nd d |krt |d ¡nd d
|
|krªt |d
|
¡nd d |krÆd d |d D nd d |krÞt |d ¡nd d|krúdd |d D nd d|krtj |d ¡nd d|kr2tj |d ¡nd d S )Nr rx r c S s g | ]}t |¡qS r ©rX r r^ r r r ra s z$AXNode.from_json.<locals>.<listcomp>r, r rZ r8 r. r{ c S s g | ]}t |¡qS r r r^ r r r ra s r r
c S s g | ]}t |¡qS r )r
|
r r^ r r r ra s rV r ) rw rx ry r, rz rZ r8 r. r{ r| r} rT r )r
|
r rQ rP r rW r ZFrameIdr r r r r s
|
ózAXNode.from_json)r r r r! rR ry r, rz rZ r8 r. r{ r| r} rT r r r" r r r r r rv > s"
|
rv z0typing.Generator[T_JSON_DICT, T_JSON_DICT, None]r c c s ddi} | V }dS )z,
|
Disables the accessibility domain.
|
ÚmethodzAccessibility.disableNr ©Úcmd_dictr r r r Údisable s ÿr c c s ddi} | V }dS )zÝ
|
Enables the accessibility domain which causes ``AXNodeId``'s to remain consistent between method calls.
|
This turns on accessibility for the page, which can impact performance until accessibility is disabled.
|
r zAccessibility.enableNr r r r r Úenable£ s ÿr ztyping.Optional[dom.NodeId]r~ z'typing.Optional[runtime.RemoteObjectId]rC z?typing.Generator[T_JSON_DICT, T_JSON_DICT, typing.List[AXNode]])rw Úbackend_node_idÚ object_idÚfetch_relativesr c c st t }| dk r| ¡ |d< |dk r.| ¡ |d< |dk rB| ¡ |d< |dk rR||d< d|d}|V }dd |d
|
D S ) aË
|
Fetches the accessibility node and partial accessibility tree for this DOM node, if it exists.
|
|
**EXPERIMENTAL**
|
|
:param node_id: *(Optional)* Identifier of the node to get the partial accessibility tree for.
|
:param backend_node_id: *(Optional)* Identifier of the backend node to get the partial accessibility tree for.
|
:param object_id: *(Optional)* JavaScript object id of the node wrapper to get the partial accessibility tree for.
|
:param fetch_relatives: *(Optional)* Whether to fetch this node's ancestors, siblings and children. Defaults to true.
|
:returns: The ``Accessibility.AXNode`` for this DOM node, if it exists, plus its ancestors, siblings and children, if requested.
|
Nr Ú backendNodeIdÚobjectIdZfetchRelativesz Accessibility.getPartialAXTree©r Úparamsc S s g | ]}t |¡qS r ©rv r r^ r r r ra Í s z'get_partial_ax_tree.<locals>.<listcomp>Únodes©rN r )rw r r r r r r r r r Úget_partial_ax_tree® s þr ztyping.Optional[int]r )Údepthr r c c sL t }| dk r| |d< |dk r*| ¡ |d< d|d}|V }dd |d D S ) a
|
Fetches the entire accessibility tree for the root Document
|
|
**EXPERIMENTAL**
|
|
:param depth: *(Optional)* The maximum depth at which descendants of the root node should be retrieved. If omitted, the full tree is returned.
|
:param frame_id: *(Optional)* The frame for whose document the AX tree should be retrieved. If omited, the root frame is used.
|
:returns:
|
Nr r zAccessibility.getFullAXTreer c S s g | ]}t |¡qS r r r^ r r r ra ç s z$get_full_ax_tree.<locals>.<listcomp>r r )r r r r r r r r Úget_full_ax_treeÐ s þr z2typing.Generator[T_JSON_DICT, T_JSON_DICT, AXNode])r r c c s8 t }| dk r| ¡ |d< d|d}|V }t |d ¡S )zô
|
Fetches the root node.
|
Requires ``enable()`` to have been called previously.
|
|
**EXPERIMENTAL**
|
|
:param frame_id: *(Optional)* The frame in whose document the node resides. If omitted, the root frame is used.
|
:returns:
|
Nr zAccessibility.getRootAXNoder r( )rN r rv r )r r r r r r r Úget_root_ax_nodeê s þr )rw r r r c c sd t }| dk r| ¡ |d< |dk r.| ¡ |d< |dk rB| ¡ |d< d|d}|V }dd |d D S )
|
a
|
Fetches a node and all ancestors up to and including the root.
|
Requires ``enable()`` to have been called previously.
|
|
**EXPERIMENTAL**
|
|
:param node_id: *(Optional)* Identifier of the node to get.
|
:param backend_node_id: *(Optional)* Identifier of the backend node to get.
|
:param object_id: *(Optional)* JavaScript object id of the node wrapper to get.
|
:returns:
|
Nr r r z#Accessibility.getAXNodeAndAncestorsr c S s g | ]}t |¡qS r r r^ r r r ra s z-get_ax_node_and_ancestors.<locals>.<listcomp>r r )rw r r r r r r r r Úget_ax_node_and_ancestors s þr )Úid_r r c c sH t }| ¡ |d< |dk r&| ¡ |d< d|d}|V }dd |d D S ) a"
|
Fetches a particular accessibility node by AXNodeId.
|
Requires ``enable()`` to have been called previously.
|
|
**EXPERIMENTAL**
|
|
:param id_:
|
:param frame_id: *(Optional)* The frame in whose document the node resides. If omitted, the root frame is used.
|
:returns:
|
ÚidNr z Accessibility.getChildAXNodesr c S s g | ]}t |¡qS r r r^ r r r ra 7 s z&get_child_ax_nodes.<locals>.<listcomp>r r )r r r r r r r r Úget_child_ax_nodes s þr rA )rw r r Úaccessible_namer, r c c s t }| dk r| ¡ |d< |dk r.| ¡ |d< |dk rB| ¡ |d< |dk rR||d< |dk rb||d< d|d}|V }d d
|
|d D S ) a
|
Query a DOM node's accessibility subtree for accessible name and role.
|
This command computes the name and role for all nodes in the subtree, including those that are
|
ignored for accessibility, and returns those that mactch the specified name and role. If no DOM
|
node is specified, or the DOM node does not exist, the command returns an error. If neither
|
``accessibleName`` or ``role`` is specified, it returns all the accessibility nodes in the subtree.
|
|
**EXPERIMENTAL**
|
|
:param node_id: *(Optional)* Identifier of the node for the root to query.
|
:param backend_node_id: *(Optional)* Identifier of the backend node for the root to query.
|
:param object_id: *(Optional)* JavaScript object id of the node wrapper for the root to query.
|
:param accessible_name: *(Optional)* Find nodes with this computed name.
|
:param role: *(Optional)* Find nodes with this computed role.
|
:returns: A list of ``Accessibility.AXNode`` matching the specified attributes, including nodes that are ignored for accessibility.
|
Nr r r ZaccessibleNamer, zAccessibility.queryAXTreer c S s g | ]}t |¡qS r r r^ r r r ra a s z!query_ax_tree.<locals>.<listcomp>r r )rw r r r r, r r r r r r Ú query_ax_tree: s þr zAccessibility.loadCompletec @ s. e Zd ZU dZded< edd dddZdS ) Ú LoadCompletez®
|
**EXPERIMENTAL**
|
|
The loadComplete event mirrors the load complete event sent by the browser to assistive
|
technology when the web page has finished loading.
|
rv rg r r c C s | t |d ¡dS )Nrg )rg r r r r r r p s ÿzLoadComplete.from_jsonN©r r r r! rR r" r r r r r r¡ d s
|
r¡ zAccessibility.nodesUpdatedc @ s. e Zd ZU dZded< edd dddZdS ) Ú NodesUpdatedz~
|
**EXPERIMENTAL**
|
|
The nodesUpdated event is sent every time a previously requested node has changed the in tree.
|
ztyping.List[AXNode]r r r c C s | dd |d D dS )Nc S s g | ]}t |¡qS r r r^ r r r ra
s z*NodesUpdated.from_json.<locals>.<listcomp>r )r r r r r r r s ÿzNodesUpdated.from_jsonNr¢ r r r r r£ w s
|
r£ )NNNN)NN)N)NNN)N)NNNNN)#Ú
|
__future__r Úutilr r Z dataclassesr ÚenumÚtypingÚ r r r r r
|
ÚEnumr$ r2 r7 r> rS rX rP rY rv r r r r r r r r r¡ r£ r r r r Ú<module> sh C %9Z
|
ü# þ ÿ ý! þ û*
|
