o N,hC{ @sfddlZddlmZddlmZmZmZmZmZddl m Z m Z m Z m Z mZddlmZddlmZmZ edZedZeeefZd ed eegeffd d Zd ed eegeffd dZdeeefd eegeffddZded eegeffddZded eegeffddZded eegeffddZded eegeffddZ deeefd eegeedefffddZ!ded eegeedefffd d!Z"dYded#ed eedeffd$d%Z#deeefd eege$effd&d'Z%deeefd eege$effd(d)Z&deeefd eegee$eedfffd*d+Z'deeefd,ed eegeffd-d.Z(deeefd,ed eegeffd/d0Z)deeefd1ed,ed eegeffd2d3Z*deeeefeefd eegeffd4d5Z+deeeeeffd eegeeefffd6d7Z,deeeeeffd eegeeefffd8d9Z-d:eeeeeffd eegeedefffd;d<Z.ded eegeffd=d>Z/ded eegeffd?d@Z0deeefd eegeffdAdBZ1dedCed eegeffdDdEZ2deeefdCed eegeffdFdGZ3dHe4d eegeffdIdJZ5dKe$ed eegeffdLdMZ6d eegeeedfffdNdOZ7deeefd1ed eegeffdPdQZ8dReegefd eegeedefffdSdTZ9dReegeeedffd eegee$eedfffdUdVZ:dReegefd eegeffdWdXZ;dS)ZN)Iterable)AnyCallableLiteralTypeVarUnion)NoAlertPresentExceptionNoSuchElementExceptionNoSuchFrameExceptionStaleElementReferenceExceptionWebDriverException)Alert) WebDriver WebElementDTtitlereturncdtffdd }|S)zAn expectation for checking the title of a page. Parameters: ----------- title : str The expected title, which must be an exact match. Returns: ------- boolean : True if the title matches, False otherwise. drivercs |jkSNrrrz/var/www/www-root/data/www/bot.pdev.uz/venv/lib/python3.10/site-packages/selenium/webdriver/support/expected_conditions.py _predicate8 ztitle_is.._predicaterrrrrrtitle_is+ rcr)aAn expectation for checking that the title contains a case-sensitive substring. Parameters: ----------- title : str The fragment of title expected. Returns: ------- boolean : True when the title matches, False otherwise. rc |jvSrrrrrrrLrz"title_contains.._predicaterrrrrtitle_contains>r"locatorcr)azAn expectation for checking that an element is present on the DOM of a page. This does not necessarily mean that the element is visible. Parameters: ----------- locator : Tuple[str, str] Used to find the element. Returns: ------- WebElement : The WebElement once it is located. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> element = WebDriverWait(driver, 10).until(EC.presence_of_element_located((By.NAME, "q"))) rc |jSr) find_elementrr$rrrgrz/presence_of_element_located.._predicateWebDriverOrWebElementr$rrr'rpresence_of_element_locatedRr+urlcr)aAn expectation for checking that the current url contains a case- sensitive substring. Parameters: ----------- url : str The fragment of url expected. Returns: ------- boolean : True when the url matches, False otherwise. rcr!r current_urlrr-rrr{rz url_contains.._predicaterr-rrr0r url_containsmr#r2patterncr)aQAn expectation for checking the current url. Parameters: ----------- pattern : str The pattern to match with the current url. Returns: ------- boolean : True when the pattern matches, False otherwise. Notes: ------ More powerful than url_contains, as it allows for regular expressions. rcst|jduSr)researchr/rr3rrrzurl_matches.._predicater)r3rrr6r url_matchessr8cr)zAn expectation for checking the current url. Parameters: ----------- url : str The expected url, which must be an exact match. Returns: ------- boolean : True when the url matches, False otherwise. rcs |jkSrr.rr0rrrrzurl_to_be.._predicaterr1rr0r url_to_ber r9cr)aAn expectation for checking the current url is different than a given string. Parameters: ----------- url : str The expected url, which must not be an exact match. Returns: ------- boolean : True when the url does not match, False otherwise rcs |jkSrr.rr0rrrrzurl_changes.._predicaterr1rr0r url_changesr#r:Fcr)aAn expectation for checking that an element is present on the DOM of a page and visible. Visibility means that the element is not only displayed but also has a height and width that is greater than 0. Parameters: ----------- locator : Tuple[str, str] Used to find the element. Returns: ------- WebElement : The WebElement once it is located and visible. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> element = WebDriverWait(driver, 10).until(EC.visibility_of_element_located((By.NAME, "q"))) rcs&zt|jWStyYdSwNF)_element_if_visibler&r rr'rrrs  z1visibility_of_element_located.._predicater(r*rr'rvisibility_of_element_locatedsr=elementcfdd}|S)a1An expectation for checking that an element, known to be present on the DOM of a page, is visible. Parameters: ----------- element : WebElement The WebElement to check. Returns: ------- WebElement : The WebElement once it is visible. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> element = WebDriverWait(driver, 10).until(EC.visibility_of(driver.find_element(By.NAME, "q"))) Notes: ------ Visibility means that the element is not only displayed but also has a height and width that is greater than 0. element is the WebElement returns the (same) WebElement once it is visible cstSrr<_r>rrrz!visibility_of.._predicaterr>rrrCr visibility_ofs rFT visibilitycCs||kr|SdS)a|An expectation for checking that an element, known to be present on the DOM of a page, is of the expected visibility. Parameters: ----------- element : WebElement The WebElement to check. visibility : bool The expected visibility of the element. Returns: ------- WebElement : The WebElement once it is visible or not visible. F) is_displayed)r>rGrrrr<sr<cr)agAn expectation for checking that there is at least one element present on a web page. Parameters: ----------- locator : Tuple[str, str] Used to find the element. Returns: ------- List[WebElement] : The list of WebElements once they are located. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> elements = WebDriverWait(driver, 10).until(EC.presence_of_all_elements_located((By.CLASS_NAME, "foo"))) rcr%r find_elementsrr'rrr(rz4presence_of_all_elements_located.._predicater(r*rr'r presence_of_all_elements_locatedr,rKcr)auAn expectation for checking that there is at least one element visible on a web page. Parameters: ----------- locator : Tuple[str, str] Used to find the element. Returns: ------- List[WebElement] : The list of WebElements once they are located and visible. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> elements = WebDriverWait(driver, 10).until(EC.visibility_of_any_elements_located((By.CLASS_NAME, "foo"))) rcsdd|jDS)NcSsg|]}t|r|qSrr@).0r>rrr DszJvisibility_of_any_elements_located.._predicate..rIrr'rrrCsz6visibility_of_any_elements_located.._predicater(r*rr'r"visibility_of_any_elements_located.r,rNcr)aAn expectation for checking that all elements are present on the DOM of a page and visible. Visibility means that the elements are not only displayed but also has a height and width that is greater than 0. Parameters: ----------- locator : Tuple[str, str] Used to find the elements. Returns: ------- List[WebElement] : The list of WebElements once they are located and visible. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> elements = WebDriverWait(driver, 10).until(EC.visibility_of_all_elements_located((By.CLASS_NAME, "foo"))) rcsDz|j}|D] }t|ddrWdSq|WSty!YdSw)NFrG)rJr<r )relementsr>r'rrras   z6visibility_of_all_elements_located.._predicater(r*rr'r"visibility_of_all_elements_locatedIs rQtext_cdtffdd }|S)aAn expectation for checking if the given text is present in the specified element. Parameters: ----------- locator : Tuple[str, str] Used to find the element. text_ : str The text to be present in the element. Returns: ------- boolean : True when the text is present, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_text_in_element = WebDriverWait(driver, 10).until( EC.text_to_be_present_in_element((By.CLASS_NAME, "foo"), "bar") ) rcs,z |jj}|vWStyYdSwr;)r&textr r element_textr$rRrrrs    z1text_to_be_present_in_element.._predicater(r$rRrrrWrtext_to_be_present_in_elementnrYcrS)aAn expectation for checking if the given text is present in the element's value. Parameters: ----------- locator : Tuple[str, str] Used to find the element. text_ : str The text to be present in the element's value. Returns: ------- boolean : True when the text is present, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_text_in_element_value = WebDriverWait(driver, 10).until( ... EC.text_to_be_present_in_element_value((By.CLASS_NAME, "foo"), "bar") ... ) rcs>z|jd}|durWdS|vWStyYdSw)NvalueFr& get_attributer rUrWrrr  z7text_to_be_present_in_element_value.._predicater(rXrrWr#text_to_be_present_in_element_values r_ attribute_csdtffdd }|S)a)An expectation for checking if the given text is present in the element's attribute. Parameters: ----------- locator : Tuple[str, str] Used to find the element. attribute_ : str The attribute to check the text in. text_ : str The text to be present in the element's attribute. Returns: ------- boolean : True when the text is present, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_text_in_element_attribute = WebDriverWait(driver, 10).until( ... EC.text_to_be_present_in_element_attribute((By.CLASS_NAME, "foo"), "bar", "baz") ... ) rcs>z|j}|durWdS|vWStyYdSwr;r\rUr`r$rRrrrr^z;text_to_be_present_in_element_attribute.._predicater()r$r`rRrrrar'text_to_be_present_in_element_attributes rbcr)aAn expectation for checking whether the given frame is available to switch to. Parameters: ----------- locator : Union[Tuple[str, str], str, WebElement] Used to find the frame. Returns: ------- boolean : True when the frame is available, False otherwise. Example: -------- >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> WebDriverWait(driver, 10).until(EC.frame_to_be_available_and_switch_to_it("frame_name")) Notes: ------ If the frame is available it switches the given driver to the specified frame. rcsTzttrtts|j|jWdS|jWdSty)YdSw)NTF) isinstancerstr switch_toframer&r rr'rrrs  z:frame_to_be_available_and_switch_to_it.._predicaterr*rr'r&frame_to_be_available_and_switch_to_it rgcr)aAn Expectation for checking that an element is either invisible or not present on the DOM. Parameters: ----------- locator : Union[WebElement, Tuple[str, str]] Used to find the element. Returns: ------- boolean : True when the element is invisible or not present, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_invisible = WebDriverWait(driver, 10).until(EC.invisibility_of_element_located((By.CLASS_NAME, "foo"))) Notes: ------ - In the case of NoSuchElement, returns true because the element is not present in DOM. The try block checks if the element is present but is invisible. - In the case of StaleElementReference, returns true because stale element reference implies that element is no longer visible. rc s@z}t|ts |j|}t|ddWSttfyYdSw)NFrOT)rcrr&r<r r )rtargetr'rrr(s  z3invisibility_of_element_located.._predicater(r*rr'rinvisibility_of_element_located srjcCst|S)aAn Expectation for checking that an element is either invisible or not present on the DOM. Parameters: ----------- element : Union[WebElement, Tuple[str, str]] Used to find the element. Returns: ------- boolean : True when the element is invisible or not present, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_invisible_or_not_present = WebDriverWait(driver, 10).until( ... EC.invisibility_of_element(driver.find_element(By.CLASS_NAME, "foo")) ... ) )rjrCrrrinvisibility_of_element9srkmarkcr)amAn Expectation for checking an element is visible and enabled such that you can click it. Parameters: ----------- mark : Union[WebElement, Tuple[str, str]] Used to find the element. Returns: ------- WebElement : The WebElement once it is located and clickable. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> element = WebDriverWait(driver, 10).until(EC.element_to_be_clickable((By.CLASS_NAME, "foo"))) rcs8}t|ts |j|}t||}|r|r|SdSr;)rcrr&rF is_enabled)rrir>rlrrrms    z+element_to_be_clickable.._predicater()rlrrrnrelement_to_be_clickableTs rocr?)aQWait until an element is no longer attached to the DOM. Parameters: ----------- element : WebElement The element to wait for. Returns: ------- boolean : False if the element is still attached to the DOM, true otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_element_stale = WebDriverWait(driver, 10).until(EC.staleness_of(driver.find_element(By.CLASS_NAME, "foo"))) cs$zWdStyYdSwNFT)rmr rArCrrrs  z staleness_of.._predicaterrErrCr staleness_ofys rqcr?)aZAn expectation for checking the selection is selected. Parameters: ----------- element : WebElement The WebElement to check. Returns: ------- boolean : True if the element is selected, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_selected = WebDriverWait(driver, 10).until(EC.element_to_be_selected(driver.find_element( By.CLASS_NAME, "foo")) ) csSr is_selectedrArCrrrrDz*element_to_be_selected.._predicaterrErrCrelement_to_be_selecteds rtcr)aBAn expectation for the element to be located is selected. Parameters: ----------- locator : Tuple[str, str] Used to find the element. Returns: ------- boolean : True if the element is selected, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_selected = WebDriverWait(driver, 10).until(EC.element_located_to_be_selected((By.CLASS_NAME, "foo"))) rcs|jSr)r&rsrr'rrrz2element_located_to_be_selected.._predicater(r*rr'relement_located_to_be_selectedsrvrscsfdd}|S)aAn expectation for checking if the given element is selected. Parameters: ----------- element : WebElement The WebElement to check. is_selected : bool Returns: ------- boolean : True if the element's selection state is the same as is_selected Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_selected = WebDriverWait(driver, 10).until( ... EC.element_selection_state_to_be(driver.find_element(By.CLASS_NAME, "foo"), True) ... ) cs kSrrrrAr>rsrrrs z1element_selection_state_to_be.._predicater)r>rsrrrwrelement_selection_state_to_besrxcrS)aAn expectation to locate an element and check if the selection state specified is in that state. Parameters: ----------- locator : Tuple[str, str] Used to find the element. is_selected : bool Returns: ------- boolean : True if the element's selection state is the same as is_selected Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_selected = WebDriverWait(driver, 10).until(EC.element_located_selection_state_to_be( (By.CLASS_NAME, "foo"), True) ) rcs.z |j}|kWStyYdSwr;)r&rsr )rr>rsr$rrrs   z9element_located_selection_state_to_be.._predicater()r$rsrrryr%element_located_selection_state_to_besrz num_windowscr)aAn expectation for the number of windows to be a certain value. Parameters: ----------- num_windows : int The expected number of windows. Returns: ------- boolean : True when the number of windows matches, False otherwise. Example: -------- >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_number_of_windows = WebDriverWait(driver, 10).until(EC.number_of_windows_to_be(2)) rcst|jkSrlenwindow_handlesrr{rrr"ruz+number_of_windows_to_be.._predicater)r{rrrrnumber_of_windows_to_besrcurrent_handlescr)aqAn expectation that a new window will be opened and have the number of windows handles increase. Parameters: ----------- current_handles : List[str] The current window handles. Returns: ------- boolean : True when a new window is opened, False otherwise. Example: -------- >>> from selenium.webdriver.support.ui import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_new_window_opened = WebDriverWait(driver, 10).until(EC.new_window_is_opened(driver.window_handles)) rcst|jtkSrr|rrrrr=r7z(new_window_is_opened.._predicater)rrrrrnew_window_is_opened(r,rcCsdtfdd}|S)aAn expectation for checking if an alert is currently present and switching to it. Returns: ------- Alert : The Alert once it is located. Example: -------- >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> alert = WebDriverWait(driver, 10).until(EC.alert_is_present()) Notes: ------ If the alert is present it switches the given driver to it. rcSs z|jjWStyYdSwr;)realertrrrrrrVs   z$alert_is_present.._predicater)rrrralert_is_presentCsrcrS)aAn expectation for checking if the given attribute is included in the specified element. Parameters: ----------- locator : Tuple[str, str] Used to find the element. attribute_ : str The attribute to check. Returns: ------- boolean : True when the attribute is included, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_attribute_in_element = WebDriverWait(driver, 10).until( ... EC.element_attribute_to_include((By.CLASS_NAME, "foo"), "bar") ... ) rcs0z |j}|duWStyYdSwr;r\)relement_attributer`r$rrrxs   z0element_attribute_to_include.._predicater()r$r`rrrrelement_attribute_to_include_rZrexpected_conditionscr)a0An expectation that any of multiple expected conditions is true. Parameters: ----------- expected_conditions : Callable[[D], T] The list of expected conditions to check. Returns: ------- T : The result of the first matching condition, or False if none do. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> element = WebDriverWait(driver, 10).until( ... EC.any_of(EC.presence_of_element_located((By.NAME, "q"), ... EC.visibility_of_element_located((By.NAME, "q")))) Notes: ------ Equivalent to a logical 'OR'. Returns results of the first matching condition, or False if none do. rc s:D]}z ||}|r|WSWqtyYqwdSr;r rexpected_conditionresultrrrany_of_conditions  z any_of..any_of_conditionr)rrrrrany_ofrhrcr)aAn expectation that all of multiple expected conditions is true. Parameters: ----------- expected_conditions : Callable[[D], Union[T, Literal[False]]] The list of expected conditions to check. Returns: ------- List[T] : The results of all the matching conditions, or False if any do not. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> elements = WebDriverWait(driver, 10).until( ... EC.all_of(EC.presence_of_element_located((By.NAME, "q"), ... EC.visibility_of_element_located((By.NAME, "q")))) Notes: ------ Equivalent to a logical 'AND'. Returns: When any ExpectedCondition is not met: False. When all ExpectedConditions are met: A List with each ExpectedCondition's return value. rc sJg}D]}z||}|sWdS||Wqty"YdSw|Sr;)appendr )rresultsrrrrrall_of_conditions z all_of..all_of_conditionr)rrrrrall_ofs rcr)aAn expectation that none of 1 or multiple expected conditions is true. Parameters: ----------- expected_conditions : Callable[[D], Any] The list of expected conditions to check. Returns: ------- boolean : True if none of the conditions are true, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> element = WebDriverWait(driver, 10).until( ... EC.none_of(EC.presence_of_element_located((By.NAME, "q"), ... EC.visibility_of_element_located((By.NAME, "q")))) Notes: ------ Equivalent to a logical 'NOT-OR'. Returns a Boolean rc s8D]}z ||}|rWdSWqtyYqwdSrprrrrrnone_of_conditions z"none_of..none_of_conditionr)rrrrrnone_ofs r)T)s   $  (!$!((  (%#   '   )  ( 0  %$    $ $(2#( *-