U bC@sddlmZddlZddlmZmZddlmZddl Z ddl Z ddl Z ddl m Z ddlmZddlmZmZddlmZdd lmZd d lmZd d lmZdadad dZGddde dZGdddeZdS)) annotationsN) b64decode encodebytes)md5)ABCMeta)BytesIO)WebDriverExceptionJavascriptException)By)keys_to_typing)Command) ShadowRootcCs@dtddd}t|ddat|ddadS)N.zgetAttribute.jsutf8zisDisplayed.js)join__name__splitpkgutilget_datadecodegetAttribute_jsisDisplayed_js)Z_pkgrH/tmp/pip-unpacked-wheel-3sqd7awy/selenium/webdriver/remote/webelement.py_load_js(src@seZdZdZdS)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__rrrrr0sr) metaclassc@seZdZdZddZddZedddd Zeddd d Zd dd dZ ddZ d dddZ ddddZ ddddZ ddddZddddZddddZd ddd Zed!dd"d#Zddd$d%Zed&dd'd(Zed&dd)d*Zddd+d,Zed&dd-d.Zed&dd/d0Zeddd1d2Zeddd3d4Zeddd5d6Zed7dd8d9Zddd:d;Zedd?Zd@dAZ dBdCZ!dPdEdFZ"e#j$dDfdddGdHZ%e#j$dDfdIddJdKZ&dLdMZ'dNdOZ(dDS)Q WebElementaRepresents 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 or not 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.cCs||_||_dSN)_parent_id)selfparentZid_rrr__init__DszWebElement.__init__cCsdt||jj|jS)Nz<<{0.__module__}.{0.__name__} (session="{1}", element="{2}")>)formattyper$Z session_idr%r&rrr__repr__Hs zWebElement.__repr__str)returncCs|tjdS)z$This element's ``tagName`` property.value)_executer ZGET_ELEMENT_TAG_NAMEr+rrrtag_nameLszWebElement.tag_namecCs|tjdS)zThe text of the element.r/)r0r ZGET_ELEMENT_TEXTr+rrrtextQszWebElement.textNonecCs|tjdS)zClicks the element.N)r0r Z CLICK_ELEMENTr+rrrclickVszWebElement.clickcCs8d}z|j||Wntk r2tdYnXdS)zSubmits a form.avar 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&scriptrrrsubmitZs  zWebElement.submitcCs|tjdS)z-Clears the text if it's a text entry element.N)r0r Z CLEAR_ELEMENTr+rrrclearkszWebElement.clearzstr | bool | WebElement | dictcCsBz|tjd|idWStk r<|jd||YSXdS)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") namer/z!return arguments[0][arguments[1]]N)r0r ZGET_ELEMENT_PROPERTYrr'r5r&r9rrr get_propertyos zWebElement.get_propertycCs|tjd|idS)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") r9r/)r0r ZGET_ELEMENT_ATTRIBUTEr:rrrget_dom_attributes zWebElement.get_dom_attributecCs&tdkrt|jdt||}|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") N#return (%s).apply(null, arguments);)rrr'r5)r&r9Zattribute_valuerrr get_attributeszWebElement.get_attributeboolcCs|tjdS)zzReturns whether the element is selected. Can be used to check if a checkbox or radio button is selected. r/)r0r ZIS_ELEMENT_SELECTEDr+rrr is_selectedszWebElement.is_selectedcCs|tjdS)z'Returns whether the element is enabled.r/)r0r ZIS_ELEMENT_ENABLEDr+rrr is_enabledszWebElement.is_enabledcsjjr`ttfdddtt|d}d|kr`g}|D]}||q@d|} t j dt |t |ddS)a3Simulates 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")) csjjt|Sr#)r'Z file_detectorZ is_local_filer-)Z keys_to_sendr+rrsz&WebElement.send_keys.. N)r2r/) r'Z _is_remotelistmaprr-rappend_uploadr0r ZSEND_KEYS_TO_ELEMENTr )r&r/Z local_filesZ remote_filesfilerr+r send_keyss  zWebElement.send_keysrcCsdt|jjddd}|jjddks6td|dkrTtd|jjd|tjd S) am Returns a shadow root of the element if there is one or an error. Only works from Chromium 96 onwards. Previous versions of Chromium based browsers will throw an assertion exception. :Returns: - ShadowRoot object or - NoSuchShadowRoot - if no shadow root was attached to element ZbrowserVersionrrZ browserName)ZfirefoxZsafariz4This only currently works in Chromium based browsers_zJPlease use Chromium based browsers with version 96 or later. Version used r/) intr$ZcapsrlowerAssertionErrorr0r ZGET_SHADOW_ROOT)r&Zbrowser_main_versionrrr shadow_roots zWebElement.shadow_rootcCs tdkrt|jdt|S)z)Whether the element is visible to a user.Nr=)rrr'r5r+rrr is_displayeds zWebElement.is_displayeddictcCs4|tjd|gdd}t|dt|ddS)aFTHIS 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())r6argsr/xyrSrT)r0r ZW3C_EXECUTE_SCRIPTround)r&old_locrrr location_once_scrolled_into_views   z+WebElement.location_once_scrolled_into_viewcCs&|tjd}|d|dd}|S)zThe size of the element.r/heightwidth)rYrZr0r GET_ELEMENT_RECT)r&sizeZnew_sizerrrr]s zWebElement.sizecCs|tjd|idS)zThe value of a CSS property.Z propertyNamer/)r0r Z!GET_ELEMENT_VALUE_OF_CSS_PROPERTY)r&Z property_namerrrvalue_of_css_propertys z WebElement.value_of_css_propertycCs.|tjd}t|dt|dd}|S)z5The location of the element in the renderable canvas.r/rSrTrU)r0r r\rV)r&rWZnew_locrrrlocations   zWebElement.locationcCs|tjdS)z7A dictionary with the size and location of the element.r/r[r+rrrrect#szWebElement.rectcCs|tjdS)z1 Returns the ARIA role of the current web elementr/)r0r ZGET_ELEMENT_ARIA_ROLEr+rrr aria_role(szWebElement.aria_rolecCs|tjdS)z0Returns the ARIA Level of the current webelementr/)r0r ZGET_ELEMENT_ARIA_LABELr+rrraccessible_name-szWebElement.accessible_namecCs|tjdS)z Gets the screenshot of the current element as a base64 encoded string. :Usage: :: img_b64 = element.screenshot_as_base64 r/)r0r ZELEMENT_SCREENSHOTr+rrrscreenshot_as_base642s zWebElement.screenshot_as_base64bytescCst|jdS)z Gets the screenshot of the current element as a binary data. :Usage: :: element_png = element.screenshot_as_png ascii)rrcencoder+rrrscreenshot_as_png>s zWebElement.screenshot_as_pngc Csn|dstdt|j}zDz$t|d}||W5QRXWntk r`YW dSXW5~XdS)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` extensionwbFT) rMendswithwarningswarn UserWarningrgopenwriteOSError)r&filenameZpngfrrr screenshotJs zWebElement.screenshotcCs|jS)zIInternal reference to the WebDriver instance this element was found from.)r$r+rrrr'fszWebElement.parentcCs|jS)aInternal 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+rrridks z WebElement.idcCst|do|j|jkS)Nrs)hasattrr%rsr&elementrrr__eq__xszWebElement.__eq__cCs || Sr#)rwrurrr__ne__{szWebElement.__ne__NcCs |si}|j|d<|j||S)a9Executes 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. rs)r%r$execute)r&commandparamsrrrr0s  zWebElement._executecCsd|tjkrtj}d|}n2|tjkr4tj}d|}n|tjkrLtj}d|}|tj||ddS)z Find an element given a By strategy and locator. :Usage: :: element = element.find_element(By.ID, 'foo') :rtype: WebElement [id="%s"].%s [name="%s"]Zusingr/r/)r ID CSS_SELECTOR CLASS_NAMENAMEr0r ZFIND_CHILD_ELEMENTr&Zbyr/rrr find_elements     zWebElement.find_elementzlist[WebElement]cCsd|tjkrtj}d|}n2|tjkr4tj}d|}n|tjkrLtj}d|}|tj||ddS)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~rr/)r rrrrr0r ZFIND_CHILD_ELEMENTSrrrr find_elementss     zWebElement.find_elementscCstt|jddS)Nutf-8)rLmd5_hashr%rf hexdigestr+rrr__hash__szWebElement.__hash__c Cst}t|dtj}||tj|d|t | }t |t sV| d}z|tjd|idWStk r}zNd|kr|WY8Sd|kr|WY Sd|kr|WYSW5d}~XYnXdS) Nwr rrIr/zUnrecognized command: POSTzCommand not found: POST z.{"status":405,"value":["GET","HEAD","DELETE"]})rzipfileZipFile ZIP_DEFLATEDrnospathrclosergetvalue isinstancer-rr0r Z UPLOAD_FILEr__str__)r&rpfpZzippedcontenterrrrHs"         zWebElement._upload)N))rrrr r(r,propertyr1r2r4r7r8r;r<r>r@rArJrOrPrXr]r^r_r`rarbrcrgrrr'rsrwrxr0r rrrrrHrrrrr"8s` !'      r") __future__rrbase64rrhashlibrrrrjrabcriorZselenium.common.exceptionsrr Zselenium.webdriver.common.byr Zselenium.webdriver.common.utilsr rzr Z shadowrootrrrrrr"rrrrs$