a 7jY @sbdZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZmZddlmZmZmZmZmZmZmZmZmZddlmZddl m!Z!ddl"m#Z#ddl$m%Z%dd l&m'Z'dd l(m)Z*dd l+m,Z,dd l-m.Z.dd l/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5ddl6m7Z7ddl8m9Z9ddl8m:Z:ddl8m;Z;ddl8mm?Z?ddl>m@Z@ddl>mAZAddl>mBZBddl>mCZCddl>mDZDddl>mEZEddl>mFZFdgZGeHdIejJeHdIejJeHdIejKe Le%IejMeDNZNeDOZOd ZPe jQd!krDd"ZPe?jRjSZTGd#dde jUZVdS)$a-----------------------------------------------------------------> | ______ __ _ ____ | | / ____/__ / /__ ____ (_)_ ______ ___ / _ \____ ________ | | \__ \/ _ \/ / _ \/ __ \/ / / / / __ `__ \ / /_) / __ \/ ___/ _ \ | | ___/ / __/ / __/ / / / / /_/ / / / / / // /_) / (_/ /__ / __/ | | /____/\___/_/\___/_/ /_/_/\__,_/_/ /_/ /_//_____/\__,_/____/\___/ | | | ---------------------------------------------------------------------> The BaseCase class is the main gateway for using The SeleniumBase Framework. It inherits Python's unittest.TestCase class and runs with pytest or pynose. All tests using BaseCase automatically launch WebDriver browsers for tests. Example Test: # -------------------------------------------------------------- from seleniumbase import BaseCase BaseCase.main(__name__, __file__) class MyTestClass(BaseCase): def test_anything(self): # Write your code here. Example: self.open("https://github.com/") self.click('span[data-target*="inputButtonText"]') self.type("input#query-builder-test", "SeleniumBase\n") self.click('a[href="/seleniumbase/SeleniumBase"]') self.assert_element("div.repository-content") self.assert_text("SeleniumBase", "strong a") # -------------------------------------------------------------- SeleniumBase methods expand and improve on existing WebDriver commands. Improvements include making WebDriver more robust, reliable, and flexible. Page elements are given enough time to load before WebDriver acts on them. Code becomes greatly simplified and easier to maintain.N)contextmanagersuppress) ElementClickInterceptedExceptionElementNotInteractableExceptionInvalidArgumentExceptionMoveTargetOutOfBoundsExceptionNoSuchElementExceptionNoSuchWindowExceptionStaleElementReferenceExceptionTimeoutExceptionWebDriverException) ActionChains)By)Keys)LOGGER) WebElement)config) __version__) decorators)NotConnectedExceptionNotUsingChromeExceptionNotUsingChromiumExceptionProxyConnectionExceptionOutOfScopeExceptionVisualException)settings)browser_launcher)download_helper) log_helper)session_helper) visual_helper) constants) css_to_xpath)js_utils) page_actions) page_utils) shared_utils)unittest_helper) xpath_to_cssBaseCaserequestsurllib3Z websocketF) Tc8s eZdZdZfddZddZeddZdd Zd d Z dddZ dddZ dddZ dddZ dddZdddZdddZddd Zdd!d"Zdd#d$Zdd%d&Zdd'd(Zdd)d*Zd+d,Zd-d.Zd/d0Zd1d2Zd3d4Zd5d6Zd7d8Zd9d:Zd;d<Zd=d>Z d?d@Z!dAdBZ"dCdDZ#dEdFZ$ddGdHZ%ddIdJZ&ddKdLZ'ddMdNZ(ddPdQZ)ddRdSZ*ddTdUZ+ddVdWZ,dXdYZ-dZd[Z.d\d]Z/d^d_Z0dd`daZ1ddbdcZ2ddddeZ3ddfdgZ4ddhdiZ5ddjdkZ6ddldmZ7ddndoZ8ddpdqZ9ddrdsZ:ddtduZ;ddvdwZdd|d}Z?dd~dZ@dddZAdddZBdddZCdddZDdddZEdddZFdddZGddZHdddZIdddZJdddZKdddZLdddZMdddZNdddZOdddZPdddZQdddZRdddZSdddZTdddZUdddZVdddZWdddZXddZYdddZZdddZ[dddZ\dddZ]dddZ^dddZ_dddZ`ddd„ZaddĄZbddƄZcddȄZdddʄZeddd̄Zfdd΄ZgddЄZhddd҄ZidddԄZjddքZkdd؄ZlddڄZmdd܄ZnddބZoddZpddZqddZrddZsddZtddZuddZvdddZwddZxddZyezdddZ{dddZ|dddZ}dddZ~ddZddZdސddZdߐddZddZddZddd Zd d Zd d ZdddZdddZdddZdddZdddZdddZdddZdddZddd Zdd!d"Zd#d$Zdd%d&Zdd'd(Zd)d*Zd+d,Zd-d.Zdd/d0Zdd1d2Zd3d4Zd5d6Zdd7d8Zdd9d:Zd;d<Zd=d>Zd?d@ZdAdBZdCdDZdEdFZddGdHZddIdJZdKdLZdMdNZdOdPZdQdRZdSdTZdUdVZdWdXZddYdZZdd\d]Zdd^d_Zdd`daZddcddZddedfZddgdhZddidjZddkdlZddndoZddpdqZddrdsZddtduZddvdwZddxdyZddzd{Zdd|d}Zdd~dZddZddZddZddZdddZÐdddZĐddZŐdddZƐdddZǐd ddZȐd ddZɐd ddZʐd ddZːd ddZ̐dddZ͐dddZΐdddZϐdddZАdddZѐddZҐddZӐddZԐddZՐddZ֐dddZאddZؐdddZِddZڐddZېdddZܐddZݐddZސddÄZߐddŐdƄZddǐdȄZdɐdʄZddːd̄ZddΐdτZddАdфZddҐdӄZddԐdՄZdd֐dׄZddؐdلZddڐdۄZdܐd݄Zdސd߄Zd ddZd!ddZd"ddZd#ddZd$ddZd%ddZd&ddZd'ddZd(ddZd)ddZd*ddZd+ddZd,ddZd-ddZd.ddZd/ddZddZd0ddZd1ddZddZdd Zd d Zd d ZgfddZddZddZddZddZddZ ddZ ddZ ddZ d d!Z d"d#Zd$d%Zd&d'Zd(d)Zd2d*d+Zd3d,d-Zd.d/Zd0d1Zd2d3Zd4d4d5Zd5d6d7Zd6d8d9Zd7d:d;Zd8d<d=Zd9d>d?Zd:d@dAZd;dBdCZdDdEZdFdGZ dHdIZ!d<fdKdL Z"d=dMdNZ#dOdPZ$dQdRZ%dSdTZ&dUdVZ'dWdXZ(dYdZZ)d[d\Z*d]d^Z+d_d`Z,dadbZ-dcddZ.dedfZ/dgdhZ0didjZ1dkdlZ2dmdnZ3dodpZ4dqdrZ5dsdtZ6dudvZ7dwdxZ8dydzZ9d{d|Z:d}d~Z;ddZ<d>ddZ=d?ddZ>ddZ?ddZ@d@ddZAdAddZBdBddZCdCddZDdDddZEdEddZFdFddZGdGddZHdHddZIdIddZJdJddZKdKddZLdLddZMddZNddZOddZPddZQdMddZRdNddZSdOddZTdPddZUdQddZVdRddZWdSddZXddZYddZZddZ[dTddZ\dd„Z]dÐdĄZ^dŐdƄZ_dǐdȄZ`dɐdʄZadːd̄Zbd͐d΄ZcdϐdЄZddѐd҄ZedUdӐdԄZfdՐdքZgdVdؐdلZhdWdېd܄ZidXdݐdބZjdYdߐdZkdZddZld[ddZmd\ddZnddZod]ddZpd^ddZqd_ddZrd`ddZsdaddZtdbddZudcddZvddddZwddZxdeddZydfddZzdgddZ{ddZ|ddZ}dhddZ~diddZdjd d Zdkd d Zdld dZdmddZdnddZdoddZdpddZdqddZdrddZdsddZdtddZdudd Zdvd!d"Zdwd#d$Zdxd%d&Zdyd'd(Zdzd)d*Zd{d+d,Zd|d-d.Zd}d/d0Zd~d1d2Zdd3d4Zdd5d6Zdd7d8Zdd9d:Zdd;d<Zdd=d>Zdd?d@ZddAdBZddCdDZddEdFZddGdHZddIdJZddKdLZddMdNZddOdPZddQdRZdSdTZdUdVZdWdXZddYdZZd[d\Zd]d^Zd_d`ZdadbZddcddZddedfZddgdhZddidjZddkdlZddmdnZddodpZddqdrZddsdtZddudvZddwdxZddydzZdd{d|Zdd}d~ZdddZdddZdddZdddZdddZdddZdddZdddZdddZÐdddZĐdddZŐdddZƐdddZǐdddZȐdddZɐdddZʐdddZːdddZ̐dddZ͐dddZΐdddZϐdddZАdddZѐdddZҐdddZӐdddZԐdddZՐdddZ֐dddZאdddZؐdddZِdddZڐddZېdddÄZܐdĐdńZݐddƐdDŽZސddȐdɄZߐddʐd˄Zd̐d̈́ZdΐdτZdАdфZddҐdӄZdԐdՄZdÐd֐dׄZdĐdؐdلZdŐdڐdۄZdƐdܐd݄Zdސd߄ZdǐddZddZdȐddZddZdɐddZddZddZddZddZdʐddZddZddZddZdːddZddZddZddZddZddZddZdd Zd̐d d Zd d ZddZddZddZddZedddZd͐ddZ ddZ ddZ dd Z dΐd!d"Z d#d$Zd%d&Zd'd(Zd)d*Zd+d,Zd-d.Zd/d0Zd1d2Zd3d4Zd5d6Zd7d8Zd9d:Zd;d<Zd=d>Zd?d@ZdAdBZdϐdCdDZdEdFZdGdHZ dАdIdJZ!dKdLZ"dMdNZ#dѐdOdPZ$dQdRZ%dSdTZ&dUdVZ'dWdXZ(dYdZZ)d[d\Z*d]d^Z+d_d`Z,dadbZ-dcddZ.dedfZ/dgdhZ0didjZ1dkdlZ2dmdnZ3dҐdodpZ4dӐdqdrZ5dsdtZ6dudvZ7dwdxZ8dydzZ9d{d|Z:d}d~Z;ddZ<ddZ=ddZ>ddZ?ddZ@ddZAdԇfdd ZBddZCeddZDeddZEZFS(r)zcstj|i||dSN)super__init___BaseCase__initialize_variablesselfargskwargs __class__EE:\soccer\ml_env\Lib\site-packages\seleniumbase/fixtures/base_case.pyr0mszBaseCase.__init__cCsd|_d|_d|_tt|_t|j|_|j|_ t j |_ g|_ g|_ d|_ d|_d|_d|_d|_d|_d|_d|_tt d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_g|_ d|_!d|_"d|_#d|_$d|_%d|_&d|_'g|_(g|_)d|_*d|_+d|_,d|_-d|_.d|_/g|_0d|_1d|_2d|_3d|_4d|_5d|_6d|_7d|_8d|_9i|_:i|_;d|_g|_?d|_@d|_Ad|_Bd|_Cg|_Di|_Ed|_Fi|_Gd|_Hi|_Id|_Ji|_Ki|_Li|_Md|_Nd|_Od|_PdS)NrF@@ about:blankTEnglish)Qdriver environmentenvr&Zmake_version_listr version_listtuple version_tuple version_infotime_BaseCase__page_sources_BaseCase__extra_actions_BaseCase__js_start_time_BaseCase__set_c_from_switch_BaseCase__frame_switch_layer_BaseCase__frame_switch_multi_BaseCase__last_saved_url_BaseCase__uc_frame_layer_BaseCase__called_setup_BaseCase__called_teardownint_BaseCase__start_time_ms_BaseCase__requests_timeout_BaseCase__page_source_count_BaseCase__screenshot_count_BaseCase__saved_pdf_count_BaseCase__logs_data_count_BaseCase__last_data_file_BaseCase__level_0_visual_f_BaseCase__will_be_skipped_BaseCase__passed_then_skipped!_BaseCase__visual_baseline_copies&_BaseCase__last_url_of_deferred_assert_BaseCase__last_page_load_url_BaseCase__last_page_screenshot#_BaseCase__last_page_screenshot_png_BaseCase__last_page_url_BaseCase__last_page_source_BaseCase__skip_reason_BaseCase__origins_to_save_BaseCase__actions_to_save_BaseCase__dont_record_open_BaseCase__dont_record_js_click!_BaseCase__new_window_on_rec_open%_BaseCase__overrided_default_timeouts"_BaseCase__added_pytest_html_extra _BaseCase__deferred_assert_count#_BaseCase__deferred_assert_failures_BaseCase__device_width_BaseCase__device_height_BaseCase__device_pixel_ratio_BaseCase__changed_jqc_theme_BaseCase__jqc_default_theme_BaseCase__jqc_default_color_BaseCase__jqc_default_width_BaseCase__saved_id _language_presentation_slides_presentation_transition_output_file_saves_rec_overrides_switch_sb_test_identifier_html_report_extra_last_page_screenshot_last_page_url _final_debug_default_driver _drivers_list_drivers_browser_map _was_skipped _chart_data _chart_count _chart_label _chart_xcount_chart_first_series_chart_series_count _tour_steps _xvfb_display _xvfb_width _xvfb_heightr3r8r8r9Z__initialize_variablesqs  zBaseCase.__initialize_variablescGsd|dkr`ddl}g}|D]}||qtjddD]}||q6|tjdd|dg|dS)aRun pytest if file was called with "python". Usage example: from seleniumbase import BaseCase BaseCase.main(__name__, __file__) class MyTestClass(BaseCase): def test_example(self): pass The run command: python my_test.py # (Instead of "pytest my_test.py") This is useful when sharing code with people who may not be aware that SeleniumBase tests are run with "pytest" instead of "python". Now, if they accidentally type "python", the tests will still run. Eg. "python my_test.py" instead of "pytest my_test.py".__main__rNz-mZpytestz-s) subprocessappendsysargvcall executable)r3namefiler4rall_argsargr8r8r9mains  z BaseCase.mainc Ks||r(|jj|fi|dSt|jddrdt|jddsdtd|j|fi|dSt|jddrt|jddr| |jj|fi|dS| | rt dd}tt|jj}Wdn1s0Yt|}||s,td|r d|}n td|d|_t|j|drRd |}|jr|js|d }|}d ||tt|d g}|j |d |||g}|j ||jr|j!r|jj}d|vsd|vsd|vr|"||"|kr|j#ddz|j$|Wnty}zt%|dst%|jdrz| t dWn(tyt&d|'|_Yn0|j(|n d|j)vsd|j)vsd|j)vsd|j)vrt*+| t d|j$|nd|j)vsd|j)vsd|j)vrt*+| t dz|j$|Wnxty} z^d| j)vsjd| j)vrd } | d!7} t,| n$d| j)vrd"} | d#7} t-| nWYd} ~ n d} ~ 00nd$|j)vr6|jj.j/} td%| z|j$|WnBty2}z(d$|j)vrtd&| nWYd}~n d}~00nld'|j)vsNd(|j)vrr| rt d)|j$|nn0d*|j)vrt&d+|'|_|j$|nWYd}~n d}~00z&|jj|kr||krt d,WnptyNt d,z| |jjstd-Wn2tyH|'|_|j$|| Yn0Yn0t0j1rh|j2sh|3| r|t d.|j2rd/|_4|j5r|jjd0rt6|jstt"t7|jt8j9j:Wdn1s0Y|;dS)1z;Navigates the current browser window to the specified page.N _is_using_uc _is_using_cdpz0open() in UC Mode now always activates CDP Mode.{Gz?https://Invalid URL: "%s"!://httpsreturn Date.now();o_urlr_url_http:https:file:T switch_tomsg default_get皙?z'Browser crashed! Will open new browser!ZERR_CONNECTION_TIMED_OUTZERR_CONNECTION_CLOSEDZERR_CONNECTION_RESETZERR_NAME_NOT_RESOLVEDg?ZERR_INTERNET_DISCONNECTEDzneterror?e=dnsNotFoundZERR_PROXY_CONNECTION_FAILED?zERR_INTERNET_DISCONNECTED: zInternet unreachable!zERR_PROXY_CONNECTION_FAILED: z*Internet unreachable and/or invalid proxy!z)Timed out receiving message from rendererz7The page load timed out after %s seconds! Will retry...z.Retry of page load timed out after %s seconds!cannot determine loading statusunexpected command response皙?zinvalid session idz*Invalid session id. Will open new browser.皙?zNo current URL!{Gz?r)httprdata)<_BaseCase__check_scope_BaseCase__is_cdp_swap_neededcdpopengetattrr=logginginfoactivate_cdp_mode disconnect_check_browser_BaseCase__needs_minimum_waitrDsleepr Exception current_urlstrstrip _BaseCase__looks_like_a_page_urlr% is_valid_urlr\r#clear_out_console_logs startswith recorder_moderdexecute_script get_originrOrFrrfget_domain_urlopen_new_windowgethasattrdebugget_new_driverrrr&check_if_time_limit_exceededrrtimeoutsZ page_loadrWAIT_FOR_RSC_ON_PAGE_LOADS undetectablewait_for_ready_state_completerL demo_modeis_jquery_activated add_js_linkr!JQueryMIN_JS$_BaseCase__demo_mode_pause_if_active) r3urlr5pre_action_url time_stamporiginactionZc_urlee2messageZpage_load_timeoutr8r8r9rs2       &                                   $z BaseCase.opencCs,|||r||n ||SdS)a!If "url" looks like a page URL, open the URL in the web browser. Otherwise, return self.get_element(URL_AS_A_SELECTOR) Examples: self.get("https://seleniumbase.io") # Navigates to the URL self.get("input.class") # Finds and returns the WebElement N)rrr get_elementr3rr8r8r9rs  z BaseCase.get css selectorNrTcCs |||stj}|jr4|tjkr4||}|}|}|||\}}|rj|jj |||ddS|rt |t t fvr|dkrt |t|s|tjkr||s|j||ddSt|s|tjkr||s|j||ddS||r |||dS|s"|jdkr,t dtj|j||||d}| |||rr|j!sr|j"sr|#|||d} t$t%|jj&} Wdn1s0Yt'|jj(} z|tjkr|jdks|jdkr|j)||dnR|jdkr |*d |n6d} d } d} t$t%|j+r|j,-d kr|.d /} |.d } |.d}|dkrjd} | r|0| r| rt$t%|*| Wdn1s0Y|jj1}|2t$t%|3| Wdn1s0Y|4|WdWdSWdn1s,0Y|5|Wn:t6y|7t dtj8|j||||d}t$t%|#|||Wdn1s0Y|jdkr|tjkr|j)||dn$|jdkr|*d |n |5|Ynzt9y>}zt$t%d|j:vr|j,-d krd|vrX|j;||dn|j<||d|rzt dWdWYd}~dSWdn1s0Y|7t dtj|j||||d}t=|j||s>t$t% |j8||ddWdn1s0Ytj|j||||d}d} d } d} t$t%|j,-d krJ|.d /} |.d } |.d}|dkrd} | rJ|0| rJ| rt$t%|*| Wdn1s0Y|jj1}|2t$t%|3| Wdn1s0Y|4|WdWYd}~dSWdn1s`0Y|r|j!s|j"s|#||||jdks|jdkr|tjksd|vr|j)||dn|j>||dnLz|5|Wn<t%y&|7tj|j||||d}|5|Yn0WYd}~nJd}~0t?y|7z|j>||dWn\t%yz|j)||dWn4t%ytj8|j||||d}|5|Yn0Yn0Ynt@y~}zd|j:vsjd|j:vrnx|7z|j>||dWn\t%yhz|j)||dWn4t%ybtj|j||||d}|5|Yn0Yn0WYd}~n d}~00t'|jj(}|| kr|jAstjBr|jj&| kr|Cn"|| dkr|dkr|4dtjD rP|jE sDt$t%|7Wdn1 s0Y| s8|jdk rNt dn t dn|jE sDt$t%|jFtjGdWdn1 s0Y| s|jdk rt dz6|jj&| k r|H|I| rt dWnZt% y@t$t%|7Wdn1 s0Y| rr?rr&r'r(r)r*r#rrr!rrrr+r$_BaseCase__current_url_is_recordableget_session_storage_itemrXPATHrrFr)r3r-rrrr/r0rr@rAZright_click_scriptrrrr8r8r9rEs     &              zBaseCase.context_clickcCs\||stj}|jr,|tjkr,||}|D]&}|j|||d|dkr0t|q0dS)aZThis method clicks on a list of elements in succession. @Params selectors_list - The list of selectors to click on. by - The type of selector to search by (Default: "css selector"). timeout - How long to wait for the selector to be visible. spacing - The amount of time to wait between clicks (in seconds).rrrN)rrrrrrrDr)r3selectors_listrrspacingr-r8r8r9 click_chainas  zBaseCase.click_chainFc CsN||stj}|jr,|tjkr,||}|||\}}|rZ|jj|||ddS| |rv| |||dS|j |||d}| |||j s|js|||||rtdz |tjd}||Wn~ttfyJ|td|j |||d}tt|Wdn1s<0YYnty\Yn0|jddd}|j rtt|jj}Wdn1s0Y||}z| d s||tj!r|n||dd |js|j r |jddn td z|tj"WnBt#yh} z(d | j$vsTd | j$vrRnWYd} ~ n d} ~ 00tj!r||rtdWnty|td|j%|||d}td| d s||n||dd |js|j r|jddn td z|tj"WnBt#yr} z(d | j$vs^d | j$vr\nWYd} ~ n d} ~ 00tj!r||rtd|j&rtdYn0|r|'d|kr| d st()d|j*|||d|j r:|jj|kr,t+,|js"t+-|jt.j/j0|n |jddn|jrJ|1dS)a}This method updates an element's text field with new text. Has multiple parts: * Waits for the element to be visible. * Waits for the element to be interactive. * Clears the text field. * Types in the new text. * Hits Enter/Submit (if the text ends in " "). @Params selector - The selector of the text field. text - The new text to type into the text field. by - The type of selector to search by. (Default: "css selector") timeout - How long to wait for the selector to be visible. retry - If True, use JS if the Selenium text update fails.rNrIr*rTr rS㥋?rrQ?Q?皙?valuez,update_text() is falling back to JavaScript!r)2rr LARGE_TIMEOUTrrrrrrr _BaseCase__shadow_typerrrrrrrDrclearr BACK_SPACE send_keysrrrrrrr=r _BaseCase__get_type_checked_textendswithrRETURNr rrrrrr set_valuer#rrr!rrr+) r3r-textrrretryr0 backspacesrrr8r8r9 update_textts        ,  (                zBaseCase.update_textc Cs||stj}|jr,|tjkr,||}|||\}}|rV|j||dS| |rv|j |||dddS|dkr|dt j t j fvr|dS|j|||d}|dkr.|ddkr.|ddkr.|dr.|dd dd d d d kr.||t j|d|dS||||jsX|jsX||||d}|jrtt|jj}Wdn1s0Y||}zr|ds||nV||dd |js|jr|jd d n t d|t j tj!r|Wnt"t#fy|t d|j$|||d}|ds`||nV||dd |js|jr|jd d n t d|t j tj!r|Yn0|jr |jj|krt%&|jst%'|jt(j)j*|n |jd d n|jr|+dS)zwThe more-reliable version of driver.send_keys() Similar to update_text(), but won't clear the text field first.NF) clear_firsthtmlrNrI r rTrrOr),rrrTrrrrrrXr rUrZENTERr[click_active_elementwait_for_element_presentcountrZreplacerZTABrrrrrrr=rrYrrDrrrrrr#rrr!rrr+)r3r-r]rrr0rr8r8r9add_texts      (            zBaseCase.add_textcCsT||stj}|jr,|tjkr,||}|||\}}|j|||||ddS)aSame as self.update_text() This method updates an element's text field with new text. Has multiple parts: * Waits for the element to be visible. * Waits for the element to be interactive. * Clears the text field. * Types in the new text. * Hits Enter/Submit (if the text ends in " "). @Params selector - The selector of the text field. text - The new text to type into the text field. by - The type of selector to search by. (Default: "css selector") timeout - How long to wait for the selector to be visible. retry - If True, use JS if the Selenium text update fails. DO NOT confuse self.type() with Python type()! They are different! rrr^N)rrrTrrrr`r3r-r]rrr^r8r8r9rEs z BaseCase.typecCsR||stj}|jr,|tjkr,||}|||\}}|j||||ddS)z_Same as self.add_text() Similar to update_text(), but won't clear the text field first.rIN)rrrTrrrrjr3r-r]rrr8r8r9rX`s zBaseCase.send_keysc Cs|r|jj|||ddS||j|||d}|jrh|||\}}|j||d}||t j |j r| r| ddkr|j||d}|d}|}||g} d| ||g} |j| d } |d r|dd }d } |D]} || q| rT|js |jr|jd d n td|tjtjrT|jsJ|n td|jrz| rl|n |jd d n8|jr|n&|rtd|jrtddS)z+Use send_keys() to press one key at a time.rNrIrrBrCrpkeysFrNrTrrO333333?rr7)rr press_keysrrgrrr<rr CSS_SELECTORrrFrGrrrFrrZrXrrrDrrr[rrrr+r) r3r-r]rrr0rArrsel_texrZ press_enterkeyr8r8r9rpksX              zBaseCase.press_keyscCsV||||\}}|r0|j|dS|j||tjd}||dS)z?Alternative to self.driver.find_element_by_*(SELECTOR).submit()NrI) rrrrsubmitrrrr)r3r-rr0r8r8r9rts zBaseCase.submitc CsN||stj}|jr,|tjkr,||}|||\}}|rT|j|dS| |rn| ||dS|j |||d}|j |||dz | tjd}||Wnttfy.|td|j |||d}| tt$tjd}||Wdn1s 0YYntyH| Yn0dS)aThis method clears an element's text field. A clear() is already included with most methods that type text, such as self.type(), self.update_text(), etc. Does not use Demo Mode highlights, mainly because we expect that some users will be calling an unnecessary clear() before calling a method that already includes clear() as part of it. In case websites trigger an autofill after clearing a field, add backspaces to make sure autofill doesn't undo the clear. @Params selector - The selector of the text field. by - The type of selector to search by. (Default: "css selector") timeout - How long to wait for the selector to be visible.NrIrMr)rrrTrrrrrZ clear_inputr _BaseCase__shadow_clearr scroll_torVrrWrXrrrrDrrr)r3r-rrr0r_r8r8r9rVs@         .zBaseCase.clearc Cs:||stj}|jr,|tjkr,||}|||\}}|rT|j|dS|j |||d}| s|j ||d}t |}||}d|}|||dS|j|||dz|tjWn`ttfy,|td|j|||d}z|tjWnty&Yn0Yn0|dS)zMake the current page focus on an interactable element. If the element is not interactable, only scrolls to it. The "tab" key is another way of setting the page focus.NrIrz%document.querySelector('%s').focus();Q?)rrrTrrrrrfocusrg is_displayedr<r=r>r?rrrvrXrNULLrrrrDrr)r3r-rrr0rAscriptr8r8r9rxsD       zBaseCase.focuscCsF|d|_|r$|jdSt|j|j| dSr.) rr\rrreloadr#rr=refreshrrr8r8r9 refresh_pages   zBaseCase.refresh_pagecCs |dS)z*The shorter version of self.refresh_page()Nr~rr8r8r9r} szBaseCase.refreshcCsd|d}|r |j}n|jj}d|vr`zddlm}||dd}Wnty^Yn0|S)N%r)unquotestrict)errors) rrrget_current_urlr=r urllib.parserr)r3rrr8r8r9rs   zBaseCase.get_current_urlcCs||dS)Nzreturn window.location.origin;)rrrr8r8r9rszBaseCase.get_origincOs|j|i|Sr.)get_page_sourcer2r8r8r9get_html"szBaseCase.get_htmlcOs:|j|i|r|jS||jr2td|jjS)NrR) rrrrrrDrr= page_sourcer2r8r8r9r%s   zBaseCase.get_page_sourcecCsf|r|jS|tt,|jddtjdt dWdn1sT0Y|j j S)NtitlerrIrR) rr get_titlerrrrgrr(rDrr=rrr8r8r9get_page_title-s  (zBaseCase.get_page_titlecCs|S)z,The shorter version of self.get_page_title())rrr8r8r9r8szBaseCase.get_titlecCs|r|jS|dS)Nzreturn navigator.userAgent;)rrget_user_agentrrr8r8r9r<s zBaseCase.get_user_agentcCs|r|jS|dS)Nz4return navigator.language || navigator.languages[0];)rrget_locale_coderrr8r8r9rAs  zBaseCase.get_locale_codecCs*||r|jdSt|ddr2|d}tt|jj }Wdn1s\0Yd|_ |j tt&||jj kr|j Wdn1s0Y|j r| d}|}dd||g}|j||jdkr|td|jtd||dS)Nrrgo_bkrdrr7)rrrgo_backrsave_recorded_actionsrrr=rr\backrrrrFrrrrDrr}r)r3rrrrr8r8r9rHs4   &   (       zBaseCase.go_backcCs||r|jdSt|ddr2|d|_|j|j rr| d}| }dd||g}|j |||dS)Nrrgo_fwrd)rrr go_forwardrrr\r=forwardrrrrFrrrr3rrrr8r8r9rds      zBaseCase.go_forwardcCs||j}t|tr |}|rt|dkrt|rF||qd|}t|rpd|_ ||d|_ qt d|| dkr|dn| dkr|ddS)aNavigates the current browser window to the start_page. You can set the start_page on the command-line in three ways: '--start_page=URL', '--start-page=URL', or '--url=URL'. If the start_page is not set, then "about:blank" will be used.rTFrr;N) r start_page isinstancerrrr%rrrdrrr)r3rnew_start_pager8r8r9open_start_pageus"        zBaseCase.open_start_pagecCs\||}||krXd|vsNd|vsN|d|dksN|dd|krX||dS)a:Opens the url in the browser if it's not the current url (*). Parameters tagged on by search engines are ignored for this method. Eg. If the current url is: * https://www.bing.com/search?q=SeleniumBase&source=hp And the url privided by this method call is: * https://www.bing.com/search?q=SeleniumBase Then the urls will be considered the same, and no open() action will be performed. This method is primarily used by Recorder Mode script generation, where both clicks and opens are recorded. So if a click() action leads to an open() action, then the script generator will attempt to convert the open() action into open_if_not_url() so that the same page isn't opened again if the user is already on the page.?q=&rN)rrfindsplitr)r3rrr8r8r9open_if_not_urlszBaseCase.open_if_not_urlcCsP|r|j|S||||\}}||r@||St|j||S)z/Returns whether the element exists in the HTML.) rris_element_presentrrr $_BaseCase__is_shadow_element_presentr$r=r3r-rr8r8r9rs   zBaseCase.is_element_presentcCsP|r|j|S||||\}}||r@||St|j||S)z3Returns whether the element is visible on the page.) rris_element_visiblerrr $_BaseCase__is_shadow_element_visibler$r=rr8r8r9rs   zBaseCase.is_element_visiblecCs<||||\}}||r,||St|j||Sr.)rrr &_BaseCase__is_shadow_element_clickabler$r"r=rr8r8r9r"s   zBaseCase.is_element_clickablecCs<||||\}}||r,||St|j||Sr.)rrr $_BaseCase__is_shadow_element_enabledr$is_element_enabledr=rr8r8r9rs   zBaseCase.is_element_enabledbodycCs`|r|j||S|td|||\}}||rN|||St |j |||S)z=Returns whether the text substring is visible in the element.{Gz?) rris_text_visiblerrDrrr !_BaseCase__is_shadow_text_visibler$r=r3r]r-rr8r8r9rs   zBaseCase.is_text_visiblecCs`|r|j||S|td|||\}}||rN|||St |j |||S)zReturns whether the text is exactly equal to the element text. (Leading and trailing whitespace is ignored in the verification.)r) rris_exact_text_visiblerrDrrr '_BaseCase__is_shadow_exact_text_visibler$r=rr8r8r9rs    zBaseCase.is_exact_text_visiblecCsH|td|||\}}||r6||Stj|j||dS)zrReturns whether the element has any non-empty text visible. Whitespace-only text is considered empty text.rr) rrDrrr +_BaseCase__is_shadow_non_empty_text_visibler$is_non_empty_text_visibler=rr8r8r9rs   z"BaseCase.is_non_empty_text_visiblecCsh|r|jj|||dS|td|||\}}||rT||||St |j ||||S)zReturns True if the element attribute/value is found. If the value is not specified, the attribute only needs to exist.rSr) rris_attribute_presentrrDrrr &_BaseCase__is_shadow_attribute_presentr$r=r3r- attributerSrr8r8r9rs   zBaseCase.is_attribute_presentcCs$|tdtj|j|ddS)z9Returns whether there's an exact match for the link text.r link textrrrDrr$rr=)r3 link_textr8r8r9rs  zBaseCase.is_link_text_visiblecCs$|tdtj|j|ddS)z