cQbjNddlmZddlZddlZddlZddlZddlmZddlm Z m Z ddl m Z ddlmZddlmZmZddlmZdd lmZdd lmZdd lmZdadad ZGd deZGddeZy)) annotationsN)ABCMeta) b64decode encodebytes)md5)BytesIO)JavascriptExceptionWebDriverException)By)keys_to_typing)Command) ShadowRootcdjtjddd}tj|dj datj|dj day)N.zgetAttribute.jsutf8zisDisplayed.js)join__name__splitpkgutilget_datadecodegetAttribute_jsisDisplayed_js)_pkgs W/var/www/html/venv/lib/python3.12/site-packages/selenium/webdriver/remote/webelement.py_load_jsr(s^ 88HNN3', -D&&t->?FFvNO%%d,<=DDVLNceZdZdZy)BaseWebElementzAbstract 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__rrr r 0s   rr ) metaclassceZdZdZd&dZdZed'dZed'dZed'dZ d&dZ d&dZ d&d Z d(d Z d'd Zd)d Zd*d Zd*dZd+dZed,dZd*dZed-dZed-dZd'dZed-dZed-dZed'dZed'dZed'dZed.dZd*dZedZed'dZ dZ!dZ"d/d!Z#e$jJd fd0d"Z&e$jJd fd1d#Z'd2d$Z(d%Z)y )3 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 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. c ||_||_yN)_parent_id)selfparentid_s r__init__zWebElement.__init__Gs rc dt|jdt|jd|jd|jd S)N)typer!r session_idr+r,s r__repr__zWebElement.__repr__KsH4:(()4:+>+>*?{4??J[[ghlhphpgqqtuurc.|jjSr))r*r3r4s rr3zWebElement.session_idNs||&&&rcF|jtjdS)zThis element's `tagName` property. Returns: The tag name of the element. Example: element = driver.find_element(By.ID, "foo") value)_executer GET_ELEMENT_TAG_NAMEr4s rtag_namezWebElement.tag_nameRs}}W99:7CCrcF|jtjdS)zThe text of the element. Returns: The text of the element. Example: element = driver.find_element(By.ID, "foo") print(element.text) r8)r9r GET_ELEMENT_TEXTr4s rtextzWebElement.text^s}}W556w??rcB|jtjy)zClicks the element. Example: element = driver.find_element(By.ID, "foo") element.click() N)r9r CLICK_ELEMENTr4s rclickzWebElement.clickk g++,rc|d} |jj||y#t$r}td|d}~wwxYw)z}Submits a form. Example: form = driver.find_element(By.NAME, "login") form.submit() 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,scriptexcs rsubmitzWebElement.submittsH [  o LL ' ' 5" o$%dekn n os! ; 6;cB|jtjy)zClears the text if it's a text entry element. Example: text_field = driver.find_element(By.NAME, "username") text_field.clear() N)r9r CLEAR_ELEMENTr4s rclearzWebElement.clearrBrc |jtjd|idS#t$r |jj d||cYSwxYw)aGets the given property of the element. Args: name: Name of the property to retrieve. Returns: The value of the property. Example: text_length = target_element.get_property("text_length") namer8z!return arguments[0][arguments[1]])r9r GET_ELEMENT_PROPERTYr r-rDr,rLs r get_propertyzWebElement.get_propertysU _==!=!=~NwW W! _;;--.QSWY]^ ^ _s$'&AAcL|jtjd|idS)aGet the HTML attribute value (not reflected properties) of the element. Returns only attributes declared in the element's HTML markup, unlike `selenium.webdriver.remote.BaseWebElement.get_attribute`. Args: name: Name of the attribute to retrieve. Returns: The value of the attribute. Example: text_length = target_element.get_dom_attribute("class") rLr8)r9r GET_ELEMENT_ATTRIBUTErNs rget_dom_attributezWebElement.get_dom_attributes$}}W::VTNKGTTrcpt t|jjdtd||}|S)azGets 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. Returns: The value of the attribute/property. Example: # Check if the "active" CSS class is applied to an element. is_active = "active" in target_element.get_attribute("class") z/* getAttribute */return ().apply(null, arguments);)rrr-rD)r,rLattribute_values r get_attributezWebElement.get_attributes?6  " J++44((99R SUY[_ rcF|jtjdS)zReturns whether the element is selected. This method is generally used on checkboxes, options in a select and radio buttons. Example: is_selected = element.is_selected() r8)r9r IS_ELEMENT_SELECTEDr4s r is_selectedzWebElement.is_selecteds}}W889'BBrcF|jtjdS)zpReturns whether the element is enabled. Example: is_enabled = element.is_enabled() r8)r9r IS_ELEMENT_ENABLEDr4s r is_enabledzWebElement.is_enableds }}W778AArc jjrttfddj tt |j d}d|vrCg}|D]"}|jj|$tdj |}jtjdj t|t|dy)aSimulates typing into the element. Use this to send simple key events or to fill out form fields. This can also be used to set file inputs. Args: value: A string for typing, or setting form fields. For setting file inputs, this could be a local file path. Examples: To send a simple key event:: form_textfield = driver.find_element(By.NAME, "username") form_textfield.send_keys("admin") or to set a file input field:: 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`jjjt|Sr))r- file_detector is_local_filestr) keys_to_sendr,s rz&WebElement.send_keys.. s#)B)B)P)PQTUaQb)cr N)r>r8)r- _is_remotelistmaprrarappend_uploadtupler9r SEND_KEYS_TO_ELEMENTr )r,r8 local_files remote_filesfiles` r send_keyszWebElement.send_keyss4 ;; ! !cGGCUO,2248K ;&! '%;P3Q\jkp\q*r rcF|jtjdS)aGet the shadow root attached to this element if present (Chromium, Firefox, Safari). Returns: The ShadowRoot object. Raises: NoSuchShadowRoot: If no shadow root was attached to element. Example: try: shadow_root = element.shadow_root except NoSuchShadowRoot: print("No shadow root attached to element") r8)r9r GET_SHADOW_ROOTr4s r shadow_rootzWebElement.shadow_roots }}W445g>>rcjt t|jjdtd|S)zvWhether the element is visible to a user. Example: is_displayed = element.is_displayed() z/* isDisplayed */return (rT)rrr-rDr4s r is_displayedzWebElement.is_displayed+s3  ! J{{)),EnEUUn*oquvvrc|jtjd|gdd}t|dt|ddS)aGet the element's location on screen after scrolling it into view. This may change without warning and scrolls the element into view before calculating coordinates for clicking purposes. Returns: The top lefthand corner location on the screen, or zero coordinates if the element is not visible. Example: loc = element.location_once_scrolled_into_view zNarguments[0].scrollIntoView(true); return arguments[0].getBoundingClientRect())rEargsr8xyrxry)r9r W3C_EXECUTE_SCRIPTround)r,old_locs r location_once_scrolled_into_viewz+WebElement.location_once_scrolled_into_view6sQ--  & &j   73<(uWS\/BCCrc`|jtjd}|d|dd}|S)zGet the size of the element. Returns: The width and height of the element. Example: size = element.size r8heightwidth)rrr9r GET_ELEMENT_RECT)r,sizenew_sizes rrzWebElement.sizeMs4}}W556w?"8ntG}ErcL|jtjd|idS)aGet the value of a CSS property. Args: property_name: The name of the CSS property to get the value of. Returns: The value of the CSS property. Example: value = element.value_of_css_property("color") propertyNamer8)r9r !GET_ELEMENT_VALUE_OF_CSS_PROPERTY)r, property_names rvalue_of_css_propertyz WebElement.value_of_css_property[s'}}WFFYfHghipqqrc|jtjd}t|dt|dd}|S)zGet the location of the element in the renderable canvas. Returns: The x and y coordinates of the element. Example: loc = element.location r8rxryrz)r9r rr|)r,r}new_locs rlocationzWebElement.locationis>-- 8 89'Bgcl+% 2EFrcF|jtjdS)zGet the size and location of the element. Returns: A dictionary with size and location of the element. Example: rect = element.rect r8rr4s rrectzWebElement.rectws}}W556w??rcF|jtjdS)zGet the ARIA role of the current web element. Returns: The ARIA role of the element. Example: role = element.aria_role r8)r9r GET_ELEMENT_ARIA_ROLEr4s r aria_rolezWebElement.aria_roles}}W::;GDDrcF|jtjdS)zGet the ARIA Level of the current webelement. Returns: The ARIA Level of the element. Example: name = element.accessible_name r8)r9r GET_ELEMENT_ARIA_LABELr4s raccessible_namezWebElement.accessible_names}}W;;*>? Xrww}}X6q9: bkkm,'3'nnW-G ==!4!4vw6GHQ Q! +s1v5)SV3?3q6I  s<-$C DD)D/D=DDDDD)returnNone)rra)rzstr | bool | WebElement | dict)r str | None)rbool)r8rarr)rr)rdict)rbytesr))rrar8rrr')rrar8rrzlist[WebElement])rr)*rr!r"r#r/r5propertyr3r;r>rArGrJrOrRrVrYr\rprsrur~rrrrrrrrrr-rrrr9r IDrrrrjr$rrr'r':s v'' D D @ @-o0-_$U" D CB) V??$ wDD,   r   @ @ E E F F B B D D<  A( 5&(UUa0')eeb0Grr') __future__rrrrrabcrbase64rrhashlibrriorselenium.common.exceptionsr r selenium.webdriver.common.byr selenium.webdriver.common.utilsr !selenium.webdriver.remote.commandr $selenium.webdriver.remote.shadowrootrrrrr r'r$rrrs]$# )#N+:5;M w HHr