hg>iddlZddlmZmZddlmZddlZddlZddl Z ddl m Z ddl m Z ddlmZddlmZddlmZd d lmZd d lmZd ed dd ZejeddZejeddZGdde Z Gdde Z!dS)N) b64decode encodebytes)md5)ABCMeta)BytesIO)WebDriverException)By)keys_to_typing)Command) ShadowRoot.zgetAttribute.jsutf8zisDisplayed.jsceZdZdZdS)BaseWebElementz Abstract Base Class for WebElement. ABC's will allow custom types to be registered as a WebElement to pass type checks. N)__name__ __module__ __qualname____doc__]/var/www/fb-scrape/myenv/lib/python3.11/site-packages/selenium/webdriver/remote/webelement.pyrr)s Drr) metaclassceZdZdZdZdZedefdZedefdZ d6dZ d Z d6d Z defd Z defd Zdefd ZdefdZdefdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!dZ"d6d Z#ede$fd!Z%defd"Z&ede'fd#Z(ede'fd$Z)defd%Z*ede'fd&Z+ede'fd'Z,edefd(Z-edefd)Z.edefd*Z/edefd+Z0defd,Z1ed-Z2edefd.Z3d/Z4d0Z5d7d1Z6e7j8dfd2Z9e7j8dfd3Z:d4Z;d5Z)formattyper session_idr r!s r__repr__zWebElement.__repr__As.MTT JJ /;; ;rreturncL|tjdS)z$This element's ``tagName`` property.value)_executer GET_ELEMENT_TAG_NAMEr)s rtag_namezWebElement.tag_nameEs}}W9::7CCrcL|tjdS)zThe text of the element.r-)r.r GET_ELEMENT_TEXTr)s rtextzWebElement.textJ}}W566w??rNcD|tjdS)zClicks the element.N)r.r CLICK_ELEMENTr)s rclickzWebElement.clickO g+,,,,,rc||tjd}|jd|dS)zSubmits a form.z./ancestor-or-self::formzvar e = arguments[0].ownerDocument.createEvent('Event');e.initEvent('submit', true, true);if (arguments[0].dispatchEvent(e)) { arguments[0].submit() }N) find_elementr XPATHrexecute_script)r!forms rsubmitzWebElement.submitSsL  +EFF ## KLP R R R R RrcD|tjdS)z-Clears the text if it's a text entry element.N)r.r CLEAR_ELEMENTr)s rclearzWebElement.clear[r8rc |tjd|idS#t$r|jd||cYSwxYw)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]])r.r GET_ELEMENT_PROPERTYrr"r<r!rCs r get_propertyzWebElement.get_property_sj _==!=~NNwW W! _ _ _;--.QSWY]^^ ^ ^ ^ _s'*&AAcR|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") rCr-)r.r GET_ELEMENT_ATTRIBUTErEs rget_dom_attributezWebElement.get_dom_attributeqs$}}W:VTNKKGTTrcN|jdtz||}|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") #return (%s).apply(null, arguments);)r"r<getAttribute_js)r!rCattribute_values r get_attributezWebElement.get_attributes06+44 1O C $rcL|tjdS)zzReturns whether the element is selected. Can be used to check if a checkbox or radio button is selected. r-)r.r IS_ELEMENT_SELECTEDr)s r is_selectedzWebElement.is_selecteds }}W899'BBrcL|tjdS)z'Returns whether the element is enabled.r-)r.r IS_ELEMENT_ENABLEDr)s r is_enabledzWebElement.is_enableds}}W788AArcltjd|tj|S)awFinds element within this element's children by ID. :Args: - id\_ - ID of child element to locate. :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: :: foo_element = element.find_element_by_id('foo') Lfind_element_by_* commands are deprecated. Please use find_element() insteadbyr-)warningswarnr:r IDr!r#s rfind_element_by_idzWebElement.find_element_by_ids0"  deee  BE 555rcltjd|tj|S)aFinds a list of elements within this element's children by ID. Will return a list of webelements if found, or an empty list if not. :Args: - id\_ - Id of child element to find. :Returns: - list of WebElement - a list with elements if any was found. An empty list if not :Usage: :: elements = element.find_elements_by_id('foo') Nfind_elements_by_* commands are deprecated. Please use find_elements() insteadrW)rYrZ find_elementsr r[r\s rfind_elements_by_idzWebElement.find_elements_by_ids0  fggg!!RU#!666rcltjd|tj|S)a~Finds element within this element's children by name. :Args: - name - name property of the element to find. :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: :: element = element.find_element_by_name('foo') rVrW)rYrZr:r NAMErEs rfind_element_by_namezWebElement.find_element_by_names0"  deee  BG4 888rcltjd|tj|S)adFinds a list of elements within this element's children by name. :Args: - name - name property to search for. :Returns: - list of webelement - a list with elements if any was found. an empty list if not :Usage: :: elements = element.find_elements_by_name('foo') r_rW)rYrZr`r rcrEs rfind_elements_by_namez WebElement.find_elements_by_names0  fggg!!RWD!999rcltjd|tj|S)aFinds element within this element's children by visible link text. :Args: - link_text - Link text string to search for. :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: :: element = element.find_element_by_link_text('Sign In') rVrW)rYrZr:r LINK_TEXTr! link_texts rfind_element_by_link_textz$WebElement.find_element_by_link_texts0"  deee  BL  BBBrcltjd|tj|S)aFinds a list of elements within this element's children by visible link text. :Args: - link_text - Link text string to search for. :Returns: - list of webelement - a list with elements if any was found. an empty list if not :Usage: :: elements = element.find_elements_by_link_text('Sign In') r_rW)rYrZr`r rhris rfind_elements_by_link_textz%WebElement.find_elements_by_link_text s0  fggg!!R\!CCCrcltjd|tj|S)aFinds element within this element's children by partially visible link text. :Args: - link_text: The text of the element to partially match on. :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: :: element = element.find_element_by_partial_link_text('Sign') rVrW)rYrZr:r PARTIAL_LINK_TEXTris r!find_element_by_partial_link_textz,WebElement.find_element_by_partial_link_texts1"  deee  B$8  JJJrcltjd|tj|S)aFinds a list of elements within this element's children by link text. :Args: - link_text: The text of the element to partial match on. :Returns: - list of webelement - a list with elements if any was found. an empty list if not :Usage: :: elements = element.find_elements_by_partial_link_text('Sign') r_rW)rYrZr`r roris r"find_elements_by_partial_link_textz-WebElement.find_elements_by_partial_link_text2s1  fggg!!R%9!KKKrcltjd|tj|S)aFinds element within this element's children by tag name. :Args: - name - name of html tag (eg: h1, a, span) :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: :: element = element.find_element_by_tag_name('h1') rVrW)rYrZr:r TAG_NAMErEs rfind_element_by_tag_namez#WebElement.find_element_by_tag_nameDs0"  deee  BKt <<  deee  BHE :::rcltjd|tj|S)aFinds elements within the element by xpath. :Args: - xpath - xpath locator string. Note: The base path will be relative to this element's location. This will select all links under this element. :: myelement.find_elements_by_xpath(".//a") However, this will select all links in the page itself. :: myelement.find_elements_by_xpath("//a") :Returns: - list of WebElement - a list with elements if any was found. An empty list if not :Usage: :: elements = element.find_elements_by_xpath("//div[contains(@class, 'foo')]") r_rW)rYrZr`r r;rys rfind_elements_by_xpathz!WebElement.find_elements_by_xpaths0<  fggg!!RXU!;;;rcltjd|tj|S)aFinds element within this element's children by class name. :Args: - name: The class name of the element to find. :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: :: element = element.find_element_by_class_name('foo') rVrW)rYrZr:r CLASS_NAMErEs rfind_element_by_class_namez%WebElement.find_element_by_class_names0"  deee  BM >>>rcltjd|tj|S)azFinds a list of elements within this element's children by class name. :Args: - name: The class name of the elements to find. :Returns: - list of WebElement - a list with elements if any was found. An empty list if not :Usage: :: elements = element.find_elements_by_class_name('foo') r_rW)rYrZr`r rrEs rfind_elements_by_class_namez&WebElement.find_elements_by_class_names0  fggg!!R]$!???rcltjd|tj|S)aFinds element within this element's children by CSS selector. :Args: - css_selector - CSS selector string, ex: 'a.nav#home' :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: :: element = element.find_element_by_css_selector('#foo') rVrW)rYrZr:r CSS_SELECTORr! css_selectors rfind_element_by_css_selectorz'WebElement.find_element_by_css_selectors0"  deee  BO< HHHrcltjd|tj|S)aFinds a list of elements within this element's children by CSS selector. :Args: - css_selector - CSS selector string, ex: 'a.nav#home' :Returns: - list of WebElement - a list with elements if any was found. An empty list if not :Usage: :: elements = element.find_elements_by_css_selector('.foo') r_rW)rYrZr`r rrs rfind_elements_by_css_selectorz(WebElement.find_elements_by_css_selectors0  fggg!!R_L!IIIrc jjrttfddtt |d}d|vrDg}|D]*}||+d|} tj 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")) c\jjt|Sr)r" file_detector is_local_filestr) keys_to_sendr!s rz&WebElement.send_keys..s&#';#<#J#J3|K\K\#]#]r N)r3r-) r" _is_remotelistmapjoinrsplitappend_uploadr.r SEND_KEYS_TO_ELEMENTr )r!r- local_files remote_filesfiles` r send_keyszWebElement.send_keyss2 ; ! 0s$^$^$^$^#%773sE??#;#;#A#A$#G#G I IJJK;&&! '<>rcH|jdtz|S)z)Whether the element is visible to a user.rK)r"r<isDisplayed_jsr)s r is_displayedzWebElement.is_displayed1s){)) 1N B  rc|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())scriptargsr-xyrr)r.r W3C_EXECUTE_SCRIPTround)r!old_locs r location_once_scrolled_into_viewz+WebElement.location_once_scrolled_into_view8se-- :fF==$&73<((73<((** *rcr|tjd}|d|dd}|S)zThe size of the element.r-heightwidth)rrr.r GET_ELEMENT_RECT)r!sizenew_sizes rrzWebElement.sizeHs<}}W566w?"8n!'],,rcR|tjd|idS)zThe value of a CSS property. propertyNamer-)r.r !GET_ELEMENT_VALUE_OF_CSS_PROPERTY)r! property_names rvalue_of_css_propertyz WebElement.value_of_css_propertyPs0}}WF MI+,,,35 5rc|tjd}t|dt|dd}|S)z5The location of the element in the renderable canvas.r-rrr)r.r rr)r!rnew_locs rlocationzWebElement.locationUsL-- 899'Bgcl++gcl++--rcL|tjdS)z7A dictionary with the size and location of the element.r-rr)s rrectzWebElement.rect]r4rcL|tjdS)z1 Returns the ARIA role of the current web elementr-)r.r GET_ELEMENT_ARIA_ROLEr)s r aria_rolezWebElement.aria_rolebs}}W:;;GDDrcL|tjdS)z0Returns the ARIA Level of the current webelementr-)r.r GET_ELEMENT_ARIA_LABELr)s raccessible_namezWebElement.accessible_namegs}}W;<?? Xrw}}X66q9::: bkkmm,,'3'' .nnW--G ==!4vw6GHHQ Q!   +qyy{{::+qyy{{::AQYY[[PP s<'C00 E:EEE.E4E EEE)r+Nr)=rrrrr$r*propertyrr0r3r7r>rArFrIrNboolrQrTr]rardrfrkrmrprrrurwr{r}rrrrrr rrdictrrrrrrrrrrr"rrrr.r r[r:r`rrrrrrr1s)  ;;;D#DDDXD@c@@@X@----RRR----_C____$ U U U U US@CTCCCCBDBBBB666(777&999(:::$CCC(DDD$KKK(LLL$===(>>>$ ; ; ;D<<rs$ ))))))))######999999++++++::::::""""""  xxs##CRC())"'"4):;;BB6JJ!!$(899@@HH     w    ` ` ` ` ` ` ` ` ` ` r