U
|
\ ±dxB ã @ sò d dl mZ d dlZd dlZd dlZd dlZd dlmZ d dlm Z d dlm
|
Z
|
d dl m Z d dlmZ d dlmZ d d lmZ d d
|
lmZ d d lmZ d d lmZ d dlmZ d dlm Z da da dd Z G dd dedZ G dd de Z!dS )é )Ú annotationsN)ÚABCMeta)Ú b64decode)Ú encodebytes)Úmd5)ÚBytesIO)ÚList)ÚJavascriptException)ÚWebDriverException)ÚBy)Úkeys_to_typingé )ÚCommand)Ú
|
ShadowRootc C s@ d t d¡d d
¡} t | d¡ d¡at | d¡ d¡ad S )NÚ.éÿÿÿÿzgetAttribute.jsÚutf8zisDisplayed.js)ÚjoinÚ__name__ÚsplitÚpkgutilÚget_dataÚdecodeÚgetAttribute_jsÚisDisplayed_js)Z_pkg© r ú[d:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\selenium/webdriver/remote/webelement.pyÚ_load_js, s r c @ s e Zd ZdZdS )ÚBaseWebElementz
Abstract Base Class for WebElement.
|
|
ABC's will allow custom types to be registered as a WebElement to
|
pass type checks.
|
N)r Ú
|
__module__Ú __qualname__Ú__doc__r r r r r 4 s r )Ú metaclassc @ s e Zd ZdZddddZdd Zeddd d
|
Zeddd d Zddd dZ dd Z
|
ddddZ ddddZ ddddZ ddddZdddd Zddd d Zddd d Zed!dd"d#Zddd$d%Zed&dd'd(Zed&dd)d*Zddd+d,Zed&dd-d.Zed&dd/d0Zeddd1d2Zeddd3d4Zeddd5d6Zed7dd8d9Z ddd:d;Z ed<d= Z eddd>d?Z d@dA Z dBdC Z!dQdEdFZ"e#j$dDfd ddGdHZ%e#j$dDfdIddJdKZ&dLddMdNZ'dOdP Z(dDS )RÚ
|
WebElementaÕ Represents a DOM element.
|
|
Generally, all interesting operations that interact with a document will be
|
performed through this interface.
|
|
All method calls will do a freshness check to ensure that the element
|
reference is still valid. This essentially determines whether the
|
element is still attached to the DOM. If this test fails, then an
|
``StaleElementReferenceException`` is thrown, and all future calls to this
|
instance will fail.
|
ÚNone)Úreturnc C s || _ || _d S ©N)Ú_parentÚ_id)ÚselfÚparentZid_r r r Ú__init__K s zWebElement.__init__c C s0 dt | j dt | j d| jj d| j d S )Nú<r z (session="z ", element="z")>)Útyper r r' Z
|
session_idr( ©r) r r r Ú__repr__O s zWebElement.__repr__Ústrc C s | tj¡d S )z$This element's ``tagName`` property.Úvalue)Ú_executer ZGET_ELEMENT_TAG_NAMEr. r r r Útag_nameR s zWebElement.tag_namec C s | tj¡d S )zThe text of the element.r1 )r2 r ZGET_ELEMENT_TEXTr. r r r ÚtextW s zWebElement.textc C s | tj¡ dS )zClicks the element.N)r2 r Z CLICK_ELEMENTr. r r r Úclick\ s zWebElement.clickc C s8 d}z| j || ¡ W n tk
|
r2 tdY nX dS )zSubmits a form.a« /* submitForm */var form = arguments[0];
|
while (form.nodeName != "FORM" && form.parentNode) {
|
form = form.parentNode;
|
}
|
if (!form) { throw Error('Unable to find containing form element'); }
|
if (!form.ownerDocument) { throw Error('Unable to find owning document'); }
|
var e = form.ownerDocument.createEvent('Event');
|
e.initEvent('submit', true, true);
|
if (form.dispatchEvent(e)) { HTMLFormElement.prototype.submit.call(form) }
|
z=To submit an element, it must be nested inside a form elementN)r' Úexecute_scriptr r
|
)r) Úscriptr r r Úsubmit` s ÿ zWebElement.submitc C s | tj¡ dS )z-Clears the text if it's a text entry element.N)r2 r Z CLEAR_ELEMENTr. r r r Úclears s zWebElement.clearz str | bool | WebElement | dictc C sB z| tjd|i¡d W S tk
|
r< | j d| |¡ Y S X dS )záGets the given property of the element.
|
|
:Args:
|
- name - Name of the property to retrieve.
|
|
:Usage:
|
::
|
|
text_length = target_element.get_property("text_length")
|
Únamer1 z!return arguments[0][arguments[1]]N)r2 r ZGET_ELEMENT_PROPERTYr
|
r* r6 ©r) r: r r r Ú get_propertyw s zWebElement.get_propertyc C s | tjd|i¡d S )a
Gets the given attribute of the element. Unlike
|
:func:`~selenium.webdriver.remote.BaseWebElement.get_attribute`, this
|
method only returns attributes declared in the element's HTML markup.
|
|
:Args:
|
- name - Name of the attribute to retrieve.
|
|
:Usage:
|
::
|
|
text_length = target_element.get_dom_attribute("class")
|
r: r1 )r2 r ZGET_ELEMENT_ATTRIBUTEr; r r r Úget_dom_attribute s z WebElement.get_dom_attributec C s* t dkrt | j dt d| |¡}|S )a= Gets the given attribute or property of the element.
|
|
This method will first try to return the value of a property with the
|
given name. If a property with that name doesn't exist, it returns the
|
value of the attribute with the same name. If there's no attribute with
|
that name, ``None`` is returned.
|
|
Values which are considered truthy, that is equals "true" or "false",
|
are returned as booleans. All other non-``None`` values are returned
|
as strings. For attributes or properties which do not exist, ``None``
|
is returned.
|
|
To obtain the exact value of the attribute or property,
|
use :func:`~selenium.webdriver.remote.BaseWebElement.get_dom_attribute` or
|
:func:`~selenium.webdriver.remote.BaseWebElement.get_property` methods respectively.
|
|
:Args:
|
- name - Name of the attribute/property to retrieve.
|
|
Example::
|
|
# Check if the "active" CSS class is applied to an element.
|
is_active = "active" in target_element.get_attribute("class")
|
Nz/* getAttribute */return (ú).apply(null, arguments);)r r r* r6 )r) r: Zattribute_valuer r r Ú get_attribute s
|
ÿzWebElement.get_attributeÚboolc C s | tj¡d S )zzReturns whether the element is selected.
|
|
Can be used to check if a checkbox or radio button is selected.
|
r1 )r2 r ZIS_ELEMENT_SELECTEDr. r r r Ú is_selected· s zWebElement.is_selectedc C s | tj¡d S )z'Returns whether the element is enabled.r1 )r2 r ZIS_ELEMENT_ENABLEDr. r r r Ú
|
is_enabled¾ s zWebElement.is_enabledc s j jr`tt fddd tt|¡ d¡}d|kr`g }|D ]}| |¡¡ q@d |¡} t
|
j d t |¡t |d¡ dS )a2 Simulates typing into the element.
|
|
:Args:
|
- value - A string for typing, or setting form fields. For setting
|
file inputs, this could be a local file path.
|
|
Use this to send simple key events or to fill out form fields::
|
|
form_textfield = driver.find_element(By.NAME, 'username')
|
form_textfield.send_keys("admin")
|
|
This can also be used to set file inputs.
|
|
::
|
|
file_input = driver.find_element(By.NAME, 'profilePic')
|
file_input.send_keys("path/to/profilepic.gif")
|
# Generally it's better to wrap the file path in one of the methods
|
# in os.path to return the actual path to support cross OS testing.
|
# file_input.send_keys(os.path.abspath("path/to/profilepic.gif"))
|
c s j j t| ¡S r& )r* Z file_detectorZ is_local_filer0 )Z keys_to_sendr. r r Ú<lambda>Ý ó z&WebElement.send_keys.<locals>.<lambda>Ú Ú
|
N)r4 r1 ) r* Z
|
_is_remoteÚlistÚmapr r0 r ÚappendÚ_uploadr2 r ZSEND_KEYS_TO_ELEMENTr )r) r1 Z local_filesZ remote_filesÚfiler r. r Ú send_keys s
|
þÿ
|
ÿzWebElement.send_keysr c C sd t | jjd d¡d }| jjd ¡ dks6td|dksTtd| jjd | tj¡d S )
|
aL Returns a shadow root of the element if there is one or an error.
|
Only works from Chromium 96 and Firefox 96 onwards. Previous versions
|
of browsers will throw an assertion exception.
|
|
:Returns:
|
- ShadowRoot object or
|
- NoSuchShadowRoot - if no shadow root was attached to element
|
ZbrowserVersionr r Z browserNameZsafariz@This only currently works in Firefox and Chromium based browsersé_ zUPlease use Firefox or Chromium based browsers with version 96 or later. Version used r1 ) Úintr' Zcapsr ÚlowerÚAssertionErrorr2 r ZGET_SHADOW_ROOT)r) Zbrowser_main_versionr r r Ú shadow_rootë s
|
ÿþÿþzWebElement.shadow_rootc C s$ t dkrt | j dt d| ¡S )z)Whether the element is visible to a user.Nz/* isDisplayed */return (r> )r r r* r6 r. r r r Ú is_displayedÿ s zWebElement.is_displayedÚdictc C s4 | tjd| gd¡d }t|d t|d dS )aE THIS PROPERTY MAY CHANGE WITHOUT WARNING. Use this to discover where
|
on the screen an element is so that we can click it. This method should
|
cause the element to be scrolled into view.
|
|
Returns the top lefthand corner location on the screen, or
|
``None`` if the element is not visible.
|
zNarguments[0].scrollIntoView(true); return arguments[0].getBoundingClientRect())r7 Úargsr1 ÚxÚy©rU rV )r2 r ZW3C_EXECUTE_SCRIPTÚround)r) Úold_locr r r Ú location_once_scrolled_into_view s þþúz+WebElement.location_once_scrolled_into_viewc C s& | tj¡d }|d |d d}|S )zThe size of the element.r1 ÚheightÚwidth)r[ r\ ©r2 r ÚGET_ELEMENT_RECT)r) ÚsizeZnew_sizer r r r_ s zWebElement.sizec C s | tjd|i¡d S )z The value of a CSS property.Z propertyNamer1 )r2 r Z!GET_ELEMENT_VALUE_OF_CSS_PROPERTY)r) Z property_namer r r Úvalue_of_css_property s z WebElement.value_of_css_propertyc C s. | tj¡d }t|d t|d d}|S )z5The location of the element in the renderable canvas.r1 rU rV rW )r2 r r^ rX )r) rY Znew_locr r r Úlocation# s zWebElement.locationc C s | tj¡d S )z7A dictionary with the size and location of the element.r1 r] r. r r r Úrect* s zWebElement.rectc C s | tj¡d S )z1Returns the ARIA role of the current web element.r1 )r2 r ZGET_ELEMENT_ARIA_ROLEr. r r r Ú aria_role/ s zWebElement.aria_rolec C s | tj¡d S )z1Returns the ARIA Level of the current webelement.r1 )r2 r ZGET_ELEMENT_ARIA_LABELr. r r r Úaccessible_name4 s zWebElement.accessible_namec C s | tj¡d S )z¯Gets the screenshot of the current element as a base64 encoded
|
string.
|
|
:Usage:
|
::
|
|
img_b64 = element.screenshot_as_base64
|
r1 )r2 r ZELEMENT_SCREENSHOTr. r r r Úscreenshot_as_base649 s
|
z WebElement.screenshot_as_base64Úbytesc C s t | j d¡S )zGets the screenshot of the current element as a binary data.
|
|
:Usage:
|
::
|
|
element_png = element.screenshot_as_png
|
Úascii)r re Úencoder. r r r Úscreenshot_as_pngE s z WebElement.screenshot_as_pngc C sn | ¡ d¡st dt¡ | j}zDz$t|d}| |¡ W 5 Q R X W n tk
|
r` Y W ¢
|
dS X W 5 ~X dS )a Saves a screenshot of the current element to a PNG image file.
|
Returns False if there is any IOError, else returns True. Use full
|
paths in your filename.
|
|
:Args:
|
- filename: The full path you wish to save your screenshot to. This
|
should end with a `.png` extension.
|
|
:Usage:
|
::
|
|
element.screenshot('/Screenshots/foo.png')
|
z.pngz^name used for saved screenshot does not match file type. It should end with a `.png` extensionÚwbFT) rO ÚendswithÚwarningsÚwarnÚ UserWarningri ÚopenÚwriteÚOSError)r) ÚfilenameZpngÚfr r r Ú
|
screenshotP s þ zWebElement.screenshotc C s | j S )zQInternal reference to the WebDriver instance this element was found
|
from.)r' r. r r r r* m s zWebElement.parentc C s | j S )a Internal ID used by selenium.
|
|
This is mainly for internal use. Simple use cases such as checking if 2
|
webelements refer to the same element, can be done using ``==``::
|
|
if element1 == element2:
|
print("These 2 are equal")
|
)r( r. r r r Úids s
|
z WebElement.idc C s t |do| j|jkS )Nru )Úhasattrr( ru ©r) Úelementr r r Ú__eq__ s zWebElement.__eq__c C s | |¡ S r& )ry rw r r r Ú__ne__ s zWebElement.__ne__Nc C s |si }| j |d< | j ||¡S )a9 Executes a command against the underlying HTML element.
|
|
Args:
|
command: The name of the command to _execute as a string.
|
params: A dictionary of named parameters to send with the command.
|
|
Returns:
|
The command's JSON response loaded into a dictionary object.
|
ru )r( r' Úexecute)r) ÚcommandÚparamsr r r r2 s
|
|
zWebElement._executec C sn |t jkr t j}d| d}n8|t jkr:t j}d| }n |t jkrVt j}d| d}| tj||d¡d S )z³Find an element given a By strategy and locator.
|
|
:Usage:
|
::
|
|
element = element.find_element(By.ID, 'foo')
|
|
:rtype: WebElement
|
ú[id="ú"]r ú[name="©Zusingr1 r1 )r ÚIDÚ CSS_SELECTORÚ
|
CLASS_NAMEÚNAMEr2 r ZFIND_CHILD_ELEMENT©r) Zbyr1 r r r Ú find_element s
|
|
|
|
zWebElement.find_elementzList[WebElement]c C sn |t jkr t j}d| d}n8|t jkr:t j}d| }n |t jkrVt j}d| d}| tj||d¡d S )zÂFind elements given a By strategy and locator.
|
|
:Usage:
|
::
|
|
element = element.find_elements(By.CLASS_NAME, 'foo')
|
|
:rtype: list of WebElement
|
r~ r r r r r1 )r r r r r
r2 r ZFIND_CHILD_ELEMENTSr r r r Ú find_elements« s
|
|
|
|
zWebElement.find_elementsrN c C s t t| j d¡ ¡ dS )Núutf-8é )rN Úmd5_hashr( rh Ú hexdigestr. r r r Ú__hash__Á s zWebElement.__hash__c
|
C sà t }t |dtj¡}| |tj |¡d ¡ | ¡ t |
|
¡ }t |t sV| d¡}z| tjd|i¡d W S tk
|
rÚ } zNdt |kr| W Y ¢8S dt |kr°| W Y ¢ S dt |krÈ| W Y ¢S W 5 d }~X Y nX d S ) NÚwr r rK r1 zUnrecognized command: POSTzCommand not found: POST z.{"status":405,"value":["GET","HEAD","DELETE"]})r ÚzipfileÚZipFileÚ ZIP_DEFLATEDrp ÚosÚpathr Úcloser ÚgetvalueÚ
|
isinstancer0 r r2 r Z UPLOAD_FILEr
|
)r) rr ÚfpZzippedÚcontentÚer r r rJ Ä s"
|
|
zWebElement._upload)N))r r r r! r+ r/ Úpropertyr3 r4 r5 r8 r9 r< r= r? rA rB rL rQ rR rZ r_ r` ra rb rc rd re ri rt r* ru ry rz r2 r r r r r rJ r r r r r# > s` )
|
|
|
r# )"Ú
|
__future__r r r rl r Úabcr Úbase64r r Úhashlibr r Úior Útypingr Zselenium.common.exceptionsr r
|
Z selenium.webdriver.common.byr Z selenium.webdriver.common.utilsr r| r Z
|
shadowrootr r r r r r# r r r r Ú<module> s*
|
