o ѷ6iO@sddlmZddlZddlZddlZddlZddlmZddlm Z m Z ddl m Z ddlmZddlmZmZddlmZdd lmZdd lmZdd lmZdadad d ZGdddedZGdddeZdS)) annotationsN)ABCMeta) b64decode encodebytes)md5)BytesIO)JavascriptExceptionWebDriverException)By)keys_to_typing)Command) ShadowRootcCs@dtddd}t|ddat|ddadS)N.zgetAttribute.jsutf8zisDisplayed.js)join__name__splitpkgutilget_datadecodegetAttribute_jsisDisplayed_js)_pkgri/var/www/hoanhtaovolam_webdjango/env/lib/python3.10/site-packages/selenium/webdriver/remote/webelement.py_load_js(src@seZdZdZdS)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__rrrrr0sr) metaclassc@seZdZdZdUddZddZedVd d ZedVd d ZedVd dZ dUddZ dUddZ dUddZ dWddZ dVddZdXddZdYddZdYd d!ZdZd#d$Zed[d&d'ZdYd(d)Zed\d+d,Zed\d-d.ZdVd/d0Zed\d1d2Zed\d3d4ZedVd5d6ZedVd7d8ZedVd9d:Zed]dd?Zed@dAZedVdBdCZ dDdEZ!dFdGZ"d^dIdJZ#e$j%dHfd_dKdLZ&e$j%dHfd`dNdOZ'dadQdRZ(dSdTZ)dHS)b 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. returnNonecCs||_||_dSN)_parent_id)selfparentid_rrr__init__Gs zWebElement.__init__c Cs.dt|jdt|jd|jd|jd S)N)typerr session_idr'r(rrr__repr__Ks.zWebElement.__repr__strcCs|jjSr%)r&r.r/rrrr.NszWebElement.session_idcC|tjdS)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_NAMEr/rrrtag_nameR zWebElement.tag_namecCr2)zThe text of the element. Returns: The text of the element. Example: element = driver.find_element(By.ID, "foo") print(element.text) r3)r4r GET_ELEMENT_TEXTr/rrrtext^s zWebElement.textcC|tjdS)zClicks the element. Example: element = driver.find_element(By.ID, "foo") element.click() N)r4r CLICK_ELEMENTr/rrrclickkzWebElement.clickc Cs<d}z |j||WdSty}ztd|d}~ww)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_scriptrr )r(scriptexcrrrsubmitts  zWebElement.submitcCr:)zClears the text if it's a text entry element. Example: text_field = driver.find_element(By.NAME, "username") text_field.clear() N)r4r CLEAR_ELEMENTr/rrrclearr=zWebElement.clearstr | bool | WebElement | dictcCs<z |tjd|idWSty|jd||YSw)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") namer3z!return arguments[0][arguments[1]])r4r GET_ELEMENT_PROPERTYr r)r>r(rErrr get_propertys   zWebElement.get_propertycC|tjd|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") rEr3)r4r GET_ELEMENT_ATTRIBUTErGrrrget_dom_attributeszWebElement.get_dom_attribute str | NonecCs*tdurt|jdtd||}|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") Nz/* getAttribute */return ().apply(null, arguments);)rrr)r>)r(rEattribute_valuerrr get_attributes zWebElement.get_attributeboolcCr2)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() r3)r4r IS_ELEMENT_SELECTEDr/rrr is_selecteds zWebElement.is_selectedcCr2)zpReturns whether the element is enabled. Example: is_enabled = element.is_enabled() r3)r4r IS_ELEMENT_ENABLEDr/rrr is_enabledszWebElement.is_enabledr3csjjr2ttfdddtt|d}d|vr2g}|D] }||q t d|} t j dt |t |ddS)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")) csjjt|Sr%)r) file_detector is_local_filer1) keys_to_sendr/rr sz&WebElement.send_keys.. N)r9r3)r) _is_remotelistmaprr1rappend_uploadtupler4r SEND_KEYS_TO_ELEMENTr )r(r3 local_files remote_filesfilerr/r send_keyss zWebElement.send_keysr cCr2)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") r3)r4r GET_SHADOW_ROOTr/rrr shadow_rootszWebElement.shadow_rootcCs$tdurt|jdtd|S)zvWhether the element is visible to a user. Example: is_displayed = element.is_displayed() Nz/* isDisplayed */return (rM)rrr)r>r/rrr is_displayed+szWebElement.is_displayeddictcCs4|tjd|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())r?argsr3xyrkrl)r4r W3C_EXECUTE_SCRIPTround)r(old_locrrr location_once_scrolled_into_view6sz+WebElement.location_once_scrolled_into_viewcCs&|tjd}|d|dd}|S)zGet the size of the element. Returns: The width and height of the element. Example: size = element.size r3heightwidth)rrrsr4r GET_ELEMENT_RECT)r(sizenew_sizerrrrvMs zWebElement.sizecCrI)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") propertyNamer3)r4r !GET_ELEMENT_VALUE_OF_CSS_PROPERTY)r( property_namerrrvalue_of_css_property[s z WebElement.value_of_css_propertycCs.|tjd}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 r3rkrlrm)r4r ruro)r(rpnew_locrrrlocationis zWebElement.locationcCr2)zGet the size and location of the element. Returns: A dictionary with size and location of the element. Example: rect = element.rect r3rtr/rrrrectwr7zWebElement.rectcCr2)zGet the ARIA role of the current web element. Returns: The ARIA role of the element. Example: role = element.aria_role r3)r4r GET_ELEMENT_ARIA_ROLEr/rrr aria_roler7zWebElement.aria_rolecCr2)zGet the ARIA Level of the current webelement. Returns: The ARIA Level of the element. Example: name = element.accessible_name r3)r4r GET_ELEMENT_ARIA_LABELr/rrraccessible_namer7zWebElement.accessible_namecCr2)zGet a base64-encoded screenshot of the current element. Returns: The screenshot of the element as a base64 encoded string. Example: img_b64 = element.screenshot_as_base64 r3)r4r ELEMENT_SCREENSHOTr/rrrscreenshot_as_base64r7zWebElement.screenshot_as_base64bytescCst|jdS)zGet the screenshot of the current element as a binary data. Returns: The screenshot of the element as binary data. Example: element_png = element.screenshot_as_png ascii)rrencoder/rrrscreenshot_as_pngr7zWebElement.screenshot_as_pngcCs|ds tdt|j}z1z$t|d }||Wdn 1s'wYWW~dSWW~dStyAYW~dSw~w)aSave a PNG screenshot of the current element to a file. 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. Returns: True if the screenshot was saved successfully, False otherwise. Example: element.screenshot("/Screenshots/foo.png") z.pngz^name used for saved screenshot does not match file type. It should end with a `.png` extensionwbNFT) lowerendswithwarningswarn UserWarningropenwriteOSError)r(filenamepngfrrr screenshots(    zWebElement.screenshotcC|jS)zGet the WebDriver instance this element was found from. Example: element = driver.find_element(By.ID, "foo") parent_element = element.parent )r&r/rrrr)szWebElement.parentcCr)a"Get the 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 ``==``:: Example: if element1 == element2: print("These 2 are equal") )r'r/rrrids z WebElement.idcCst|do |j|jkS)Nr)hasattrr'rr(elementrrr__eq__szWebElement.__eq__cCs || Sr%)rrrrr__ne__s zWebElement.__ne__NcCs |si}|j|d<|j||S)a?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. r)r'r&execute)r(commandparamsrrrr4s  zWebElement._executecC,|jj||\}}|tj||ddS)aFind an element given a By strategy and locator. Args: by: The locating strategy to use. Default is `By.ID`. Supported values include: - By.ID: Locate by element ID. - By.NAME: Locate by the `name` attribute. - By.XPATH: Locate by an XPath expression. - By.CSS_SELECTOR: Locate by a CSS selector. - By.CLASS_NAME: Locate by the `class` attribute. - By.TAG_NAME: Locate by the tag name (e.g., "input", "button"). - By.LINK_TEXT: Locate a link element by its exact text. - By.PARTIAL_LINK_TEXT: Locate a link element by partial text match. - RelativeBy: Locate elements relative to a specified root element. value: The locator value to use with the specified `by` strategy. Returns: The first matching `WebElement` found on the page. Example: element = driver.find_element(By.ID, "foo") usingr3r3)r&locator_converterconvertr4r FIND_CHILD_ELEMENTr(byr3rrr find_elementzWebElement.find_elementlist[WebElement]cCr)aFind elements given a By strategy and locator. Args: by: The locating strategy to use. Default is `By.ID`. Supported values include: - By.ID: Locate by element ID. - By.NAME: Locate by the `name` attribute. - By.XPATH: Locate by an XPath expression. - By.CSS_SELECTOR: Locate by a CSS selector. - By.CLASS_NAME: Locate by the `class` attribute. - By.TAG_NAME: Locate by the tag name (e.g., "input", "button"). - By.LINK_TEXT: Locate a link element by its exact text. - By.PARTIAL_LINK_TEXT: Locate a link element by partial text match. - RelativeBy: Locate elements relative to a specified root element. value: The locator value to use with the specified `by` strategy. Returns: List of `WebElements` matching locator strategy found on the page. Example: element = driver.find_elements(By.ID, "foo") rr3)r&rrr4r FIND_CHILD_ELEMENTSrrrr find_elementsrzWebElement.find_elementsintcCstt|jddS)Nutf-8)rmd5_hashr'r hexdigestr/rrr__hash__0szWebElement.__hash__c Cst}t|dtj}||tj|d|t | }t |t s+| d}z |tjd|idWStyn}z+dt |vrM|WYd}~Sdt |vr[|WYd}~Sdt |vri|WYd}~Sd}~ww) Nwrrdr3zUnrecognized command: POSTzCommand not found: POST z.{"status":405,"value":["GET","HEAD","DELETE"]})rzipfileZipFile ZIP_DEFLATEDrospathrclosergetvalue isinstancer1rr4r UPLOAD_FILEr )r(rfpzippedcontenterrrr_3s&      zWebElement._upload)r#r$)r#r1)r#rD)r#rL)r#rP)r3r1r#r$)r#r )r#ri)r#rr%)r#r")r#r)r#r)*rrrr r+r0propertyr.r6r9r<rArCrHrKrOrRrTrergrhrqrvr{r}r~rrrrrr)rrrr4r IDrrrr_rrrrr":sf        " +                  r") __future__rrrrrabcrbase64rrhashlibrriorselenium.common.exceptionsrr selenium.webdriver.common.byr selenium.webdriver.common.utilsr !selenium.webdriver.remote.commandr $selenium.webdriver.remote.shadowrootr rrrrr"rrrrs&