`1h dZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddlm Z m Z ddlmZmZddlmZddlmZmZmZmZmZmZddlmZmZmZmZmZdd lm Z dd l!m"Z"dd l#m$Z$dd l%m&Z&dd l'm(Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0m1Z1ddl2m3Z3ddl4m5Z5ddl6m7Z7m8Z8m9Z9ddl:m;Z;ddlm?Z?ddl@mAZAddlBmCZCddlDmEZEddlFmGZGddlHmIZImJZJddlKmLZLdd lMmNZNdd!lOmPZPdd"lQmRZRdd#lSmTZTdd$lUmVZVdd%lWmXZXdd&lYmZZZda[da\d'Z]d(Z^ d7d)e_d*ee`ePfd+ead,ead-eeAd.ePf d/Zbd0ee1d.efd1ZcGd2d3e 4ZdGd5d6edZey)8zThe WebDriver implementation.N)ABCMeta) b64decodeurlsafe_b64encode)asynccontextmanagercontextmanager) import_module)AnyDictListOptionalTypeUnion)InvalidArgumentExceptionJavascriptExceptionNoSuchCookieExceptionNoSuchElementExceptionWebDriverException)Browser)BrowsingContext)Network)Script)Session)Storage) WebExtension)By) ArgOptions BaseOptions) PrintOptions)Timeouts) CredentialVirtualAuthenticatorOptionsrequired_virtual_authenticator) RelativeBy)Dialog)BidiConnection) ClientConfig)Command) ErrorHandler)FedCM) FileDetectorLocalFileDetector)LocatorConverter)Mobile)RemoteConnection) ScriptKey) ShadowRoot)SwitchTo) WebElement)WebSocketConnectionc(ts tdayy)Nz"selenium.webdriver.common.bidi.cdp)cdpra/var/www/skyplay_api_hub/venv/lib/python3.12/site-packages/selenium/webdriver/remote/webdriver.py import_cdpr;Ps @A r9cztj|}i}|jD] \}}|||< dig|diS)aMakes a W3C alwaysMatch capabilities object. Filters out capability names that are not in the W3C spec. Spec-compliant drivers will reject requests containing unknown capability names. Moves the Firefox profile, if present, from the old location to the new Firefox options object. Parameters: ----------- caps : dict - A dictionary of capabilities requested by the caller. capabilities) firstMatch alwaysMatch)copydeepcopyitems)caps always_matchkvs r: _create_capsrGVsK == DL 1 Q B4 M NNr9r=command_executor keep_aliveignore_local_proxy client_configreturnct|tr#|xs t|}||_t |}ddlm}ddlm}ddl m }ddl m }||||g} tfd| Dt} | |||| S) N)remote_server_addr)rKr)ChromeRemoteConnection)EdgeRemoteConnection)FirefoxRemoteConnection)SafariRemoteConnectionc3`K|]%}|jjdk(s"|'yw) browserNameN) browser_nameget).0cr=s r: z(get_remote_connection..|s(_!Q^^|?O?OP]?^-^A_s#..)rNrI ignore_proxyrK) isinstancestrr(rNr0+selenium.webdriver.chrome.remote_connectionrO)selenium.webdriver.edge.remote_connectionrP,selenium.webdriver.firefox.remote_connectionrQ+selenium.webdriver.safari.remote_connectionrRnext) r=rHrIrJrKrOrPrQrR candidateshandlers ` r:get_remote_connectionrdks|"C(%ZIY)Z +; (+-HRNTR(*>@VXopJ_z_aqrG +'#  r9optionscdii}g}|D]!}|j|j#t|}i}t|D]n}|}|dz|ks||j }|D]I} | ||dzj vs||| ||dz| k(s1|j | ||| iKpi} |j D] \} } | | | < |D] }| D]} || =| |dd<||dd<|S)Nr=r&r?r>)appendto_capabilitieslenrangekeysupdaterB) rer=optsopt opts_sizesamesiesi min_index first_keyskysalwaysrErFs r:create_matchesrvsW"B'L D+ C'')*+D IH9 E q59 i--/J! E$q1u+**,,Is+tAE{3/?? d9oc.B(CD E EF 1q  A! 39L /15L . r9ceZdZdZy) BaseWebDriverzAbstract Base Class for all Webdriver subtypes. ABC's allow custom implementations of Webdriver to be registered so that isinstance type checks will succeed. N)__name__ __module__ __qualname____doc__r8r9r:rxrxsr9rx) metaclassceZdZdZeZeZ d}dee e fde de e de eeeefde ede ed e ed dfd Zd Zd Zde eede ede ej2fdZedZed efdZed e fdZ dZ!dZ"de#d dfdZ$dZ%de d efdZ&dZ'de de#fdZ(d~d e d!e e#e e)fd e#e e)ffd"Z*d#e d dfd$Z+ed e fd%Z,d~d&e d e-fd'Z.d(e-d dfd)Z/d ee fd*Z0d&e fd+Z1d&e fd,Z2ed e fd-Z3ed e fd.Z4dd/Z5dd0Z6ed e fd1Z7ed ee fd2Z8dd3Z9dd4Z:dd5Z;d~d6e e<d e fd7Z=ed e>fd8Z?dd9Z@dd:ZAdd;ZBd ee#fd<ZCd e eDfd=ZEdd>ZFdd?ZGdd@ZHdAeId dfdBZJdAeId dfdCZKdAeId dfdDZLed eMfdEZNeNjddFZNePjdfdGe e d efdHZRePjdfdGe e d eefdIZSed e#fdJZTd e fdKZUd e fdLZVd eWfdMZXd e fdNZYddOe d dfdPZZddOe d e#fdQZ[ddReIdSeIdOe d e#fdTZ\dd e#fdUZ]dOe d dfdVZ^d e#fdWZ_dd e#fdXZ`ed e fdYZaeajddZZaed[Zbebjdd\Zbd]Zcedd^Zeed_Zfd`ZgedaZhedbZiedcZjeddZkedeZledfZmdgZndeod dfdhZped e fdiZqerddjZserdketd dfdlZuerd eetfdmZverdnee ewfd dfdoZxerddpZyerdqe d dfdrZzd e{fdsZ|dte due d dfdvZ}ddwZ~ed efdxZed e fdyZdzZed{Zdd|Zy) WebDriveraControls a browser by sending commands to a remote server. This server is expected to be running the WebDriver wire protocol as defined at https://www.selenium.dev/documentation/legacy/json_wire_protocol/. Attributes: ----------- session_id - String ID of the browser session started and controlled by this WebDriver. capabilities - Dictionary of effective capabilities of this browser session as returned by the remote server. See https://www.selenium.dev/documentation/legacy/desired_capabilities/ command_executor : str or remote_connection.RemoteConnection object used to execute commands. error_handler - errorhandler.ErrorHandler object used to handle errors. NrHrI file_detectorrelocator_converterweb_element_clsrKrLc| tdt|trt|}d} n|j }|j } ||_t|j ttfrt|||| ||_d|_ d|_ i|_ i|_ t|_t!||_t%||_|xs t)|_|xs t-|_|xs |j0|_d|_|j5|j7|t9||_d|_d|_d|_ d|_!d|_"d|_#d|_$d|_%y)afCreate a new driver that will issue commands using the wire protocol. Parameters: ----------- command_executor : str or remote_connection.RemoteConnection - Either a string representing the URL of the remote server or a custom remote_connection.RemoteConnection object. Defaults to 'http://127.0.0.1:4444/wd/hub'. keep_alive : bool (Deprecated) - Whether to configure remote_connection.RemoteConnection to use HTTP keep-alive. Defaults to True. file_detector : object or None - Pass a custom file detector object during instantiation. If None, the default LocalFileDetector() will be used. options : options.Options - Instance of a driver options.Options class. locator_converter : object or None - Custom locator converter to use. Defaults to None. web_element_cls : class - Custom class to use for web elements. Defaults to WebElement. client_config : object or None - Custom client configuration to use. Defaults to None. Nz`missing 1 required keyword-only argument: 'options' (instance of driver `options.Options` class)F)rHrIrJrKT)& TypeErrorr[listrvrh_ignore_local_proxyrHr\bytesrd _is_remote session_idrCpinned_scriptsr* error_handlerr3 _switch_tor/_mobiler-rr.r_web_element_cls_authenticator_id start_client start_sessionr+_fedcm_websocket_connection_script_network_browser _bidi_session_browsing_context_storage _webextension) selfrHrIrrerrrKr=rs r:__init__zWebDriver.__init__seB ?r  &)'2L"' "224L")"="=  0 d++c5\ :$9!1%#6+ %D !  )^"4.d| *A.?.A!2!H6F6H / H43H3H!%  <(Dk %)"   !!% !r9czdt|jdt|jd|jdS)N<.z (session="z")>)typerzryrrs r:__repr__zWebDriver.__repr__ s94:(()4:+>+>*?{4??J[[^__r9c|SNr8rs r: __enter__zWebDriver.__enter__s r9exc_typeexc tracebackc$|jyr)quit)rrrrs r:__exit__zWebDriver.__exit__s r9c/Kd}t|j|s|j}||i||_ d|r||_yy#|r||_wwxYww)aAOverrides the current file detector (if necessary) in limited context. Ensures the original file detector is set afterwards. Parameters: ----------- file_detector_class : object - Class of the desired file detector. If the class is different from the current file_detector, then the class is instantiated with args and kwargs and used as a file detector during the duration of the context manager. args : tuple - Optional arguments that get passed to the file detector class during instantiation. kwargs : dict - Keyword arguments, passed the same way as args. Example: -------- >>> with webdriver.file_detector_context(UselessFileDetector): >>> someinput.send_keys('/etc/hosts') N)r[r)rfile_detector_classargskwargs last_detectors r:file_detector_contextzWebDriver.file_detector_contextsc* $,,.AB ..M!4d!Ef!ED  3 %2"}%2"s2AA A AAc|jSr)rrs r:mobilezWebDriver.mobile:s ||r9cRd|jvr|jdStd)zReturns the name of the underlying browser for this instance. Example: -------- >>> name = driver.name rTz1browserName not specified in session capabilities)rCKeyErrorrs r:namezWebDriver.name>s+ DII %99]+ +JKKr9cy)zxCalled before starting a new session. This method may be overridden to define custom startup behavior. Nr8rs r:rzWebDriver.start_clientJs r9cy)zCalled after executing a quit command. This method may be overridden to define custom shutdown behavior. Nr8rs r: stop_clientzWebDriver.stop_clientQs r9r=c:t|} |jtj|d}|j d|_|j d|_y#t$r4t|dr&|j|jjwxYw)zCreates a new session with the desired capabilities. Parameters: ----------- capabilities : dict - A capabilities dict to start the session with. value sessionIdr=serviceN) rGexecuter) NEW_SESSIONrVrrC Exceptionhasattrrstop)rr=rCresponses r:rzWebDriver.start_sessionYsL) ||G$7$7>wGH≪7DO ^4DI tY'DLL,D !!#  s AA=Bc`t|tr0i}|jD]\}}j|||<|St|jrd|j iSt|j rd|j iSt|trtfd|DS|S)N#element-6066-11e4-a52e-4f735466cecf"shadow-6066-11e4-a52e-4f735466cecfc3@K|]}j|ywr) _wrap_valuerWitemrs r:rYz(WebDriver._wrap_value..wsA4((.A)r[dictrBrrid_shadowroot_clsr)rr convertedkeyvals` r:rzWebDriver._wrap_valuels eT "I!KKM 7S!%!1!1#!6 # 7  eT22 39588D D eT11 28%((C C eT "A5AA A r9 element_idc&|j||S)z6Creates a web element with the specified `element_id`.)r)rrs r:create_web_elementzWebDriver.create_web_elementzs$$T:66r9c.t|tr_d|vrj|dSd|vrj|dS|j D]\}}j |||<|St|t rt fd|DS|S)Nrrc3@K|]}j|ywr) _unwrap_valuers r:rYz*WebDriver._unwrap_value..sCT**40Cr)r[rrrrBrr)rrrrs` r:rzWebDriver._unwrap_value~s eT "4=..u5Z/[\\3u<++D%8\2]^^!KKM 5S!//4c  5L eT "CUCC C r9cmdcmd_argsc2|jd||ddS)aExecute Chrome Devtools Protocol command and get returned result The command and command args should follow chrome devtools protocol domains/commands, refer to link https://chromedevtools.github.io/devtools-protocol/ Parameters: ----------- cmd : str, - Command name cmd_args : dict - Command args - Empty dict {} if there is no command args Returns: -------- A dict, empty dict {} if there is no result to return. - To getResponseBody: {'base64Encoded': False, 'body': 'response body string'} Example: -------- >>> driver.execute_cdp_cmd("Network.getResponseBody", {"requestId": requestId}) executeCdpCommand)rparamsr)r)rrrs r:execute_cdp_cmdzWebDriver.execute_cdp_cmds!2||/1QRSZ[[r9driver_commandrcb|j|}|jr$|sd|ji}nd|vr|j|d<|jj||}|rA|jj ||j |jdd|d<|Sdd|jdS)aSends a command to be executed by a command.CommandExecutor. Parameters: ----------- driver_command : str - The name of the command to execute as a string. params : dict - A dictionary of named Parameters to send with the command. Returns: -------- dict - The command's JSON response loaded into a dictionary object. rrNr)successrr)rrrHrrcheck_responserrV)rrrrs r:rzWebDriver.executes!!&) ??%t7F*&*oo{#((00H     - -h 7 $ 2 28<<3N OHW Ot$//JJr9urlcH|jtjd|iy)aNavigate the browser to the specified URL in the current window or tab. The method does not return until the page is fully loaded (i.e. the onload event has fired). Parameters: ----------- url : str - The URL to be opened by the browser. - Must include the protocol (e.g., http://, https://). Example: -------- >>> driver = webdriver.Chrome() >>> driver.get("https://example.com") rN)rr)GET)rrs r:rVz WebDriver.gets$ W[[5#,/r9c`|jtjjddS)zReturns the title of the current page. Example: -------- >>> element = driver.find_element(By.ID, "foo") >>> print(element.title()) r)rr) GET_TITLErVrs r:titlezWebDriver.titles&||G--.227B??r9scriptcNt|}||j|j<|S)zStore common javascript scripts to be executed later by a unique hashable ID. Example: -------- >>> script = "return document.getElementById('foo').value" )r1rr)rr script_keyscript_key_instances r: pin_scriptzWebDriver.pin_scripts,( 36</223""r9rc |jj|jy#t$rtd|d|jdwxYw)zuRemove a pinned script from storage. Example: -------- >>> driver.unpin(script_key) zNo script with key: z existed in N)rpoprr)rrs r:unpinzWebDriver.unpinsT k    # #JMM 2 k1*\$J]J]I^_`fj j ks %(&Ac,t|jS)zReturn a list of all pinned scripts. Example: -------- >>> pinned_scripts = driver.get_pinned_scripts() )rrrs r:get_pinned_scriptszWebDriver.get_pinned_scriptssD''((r9ct|tr |j|j}t |}tj}|j|||ddS#t$r t dwxYw)aSynchronously Executes JavaScript in the current window/frame. Parameters: ----------- script : str - The javascript to execute. *args : tuple - Any applicable arguments for your JavaScript. Example: -------- >>> input_id = "username" >>> input_value = "test_user" >>> driver.execute_script("document.getElementById(arguments[0]).value = arguments[1];", input_id, input_value) z Pinned script could not be foundrrr) r[r1rrrrrr)W3C_EXECUTE_SCRIPTrrrrconverted_argscommands r:execute_scriptzWebDriver.execute_scriptsy" fi ( N,,VYY7d,,||G%OPQXYY  N)*LMM Ns AA3cht|}tj}|j|||ddS)aAsynchronously Executes JavaScript in the current window/frame. Parameters: ----------- script : str - The javascript to execute. *args : tuple - Any applicable arguments for your JavaScript. Example: -------- >>> script = "var callback = arguments[arguments.length - 1]; " ... "window.setTimeout(function(){ callback('timeout') }, 3000);" >>> driver.execute_async_script(script) rr)rr)W3C_EXECUTE_SCRIPT_ASYNCrrs r:execute_async_scriptzWebDriver.execute_async_script"s4"d22||G%OPQXYYr9cF|jtjdS)zsGets the URL of the current page. Example: -------- >>> print(driver.current_url) r)rr)GET_CURRENT_URLrs r: current_urlzWebDriver.current_url8||G334W==r9cF|jtjdS)zvGets the source of the current page. Example: -------- >>> print(driver.page_source) r)rr)GET_PAGE_SOURCErs r: page_sourcezWebDriver.page_sourceBrr9cB|jtjy)zaCloses the current window. Example: -------- >>> driver.close() N)rr)CLOSErs r:closezWebDriver.closeLs W]]#r9c |jtj|j|jj y#|j|jj wxYw)zzQuits the driver and closes every associated window. Example: -------- >>> driver.quit() N)rr)QUITrrHrrs r:rzWebDriver.quitUsW * LL &      ! ! ' ' )      ! ! ' ' )s A ,A8cF|jtjdS)zReturns the handle of the current window. Example: -------- >>> print(driver.current_window_handle) r)rr)W3C_GET_CURRENT_WINDOW_HANDLErs r:current_window_handlezWebDriver.current_window_handlebs||GAAB7KKr9cF|jtjdS)zReturns the handles of all windows within the current session. Example: -------- >>> print(driver.window_handles) r)rr)W3C_GET_WINDOW_HANDLESrs r:window_handleszWebDriver.window_handlesl||G::;GDDr9cHtj}|j|dy)zMaximizes the current window that webdriver is using. Example: -------- >>> driver.maximize_window() N)r)W3C_MAXIMIZE_WINDOWr)rrs r:maximize_windowzWebDriver.maximize_windowvs-- Wd#r9cB|jtjy)zInvokes the window manager-specific 'full screen' operation. Example: -------- >>> driver.fullscreen_window() N)rr)FULLSCREEN_WINDOWrs r:fullscreen_windowzWebDriver.fullscreen_windows W../r9cB|jtjy)z9Invokes the window manager-specific 'minimize' operation.N)rr)MINIMIZE_WINDOWrs r:minimize_windowzWebDriver.minimize_windows W,,-r9 print_optionscpi}|r|j}|jtj|dS)zTakes PDF of the current page. The driver makes a best effort to return a PDF based on the provided Parameters. Example: -------- >>> driver.print_page() r)to_dictrr) PRINT_PAGE)rrres r: print_pagezWebDriver.print_pages6 #++-G||G..8AAr9c|jS)ahReturn an object containing all options to switch focus into. Returns: -------- SwitchTo: an object containing all options to switch focus into. Examples: -------- >>> element = driver.switch_to.active_element >>> alert = driver.switch_to.alert >>> driver.switch_to.default_content() >>> driver.switch_to.frame("frame_name") >>> driver.switch_to.frame(1) >>> driver.switch_to.frame(driver.find_elements(By.TAG_NAME, "iframe")[0]) >>> driver.switch_to.parent_frame() >>> driver.switch_to.window("main") )rrs r: switch_tozWebDriver.switch_tos&r9cB|jtjy)ztGoes one step backward in the browser history. Example: -------- >>> driver.back() N)rr)GO_BACKrs r:backzWebDriver.back W__%r9cB|jtjy)zvGoes one step forward in the browser history. Example: -------- >>> driver.forward() N)rr) GO_FORWARDrs r:forwardzWebDriver.forwards W''(r9cB|jtjy)zdRefreshes the current page. Example: -------- >>> driver.refresh() N)rr)REFRESHrs r:refreshzWebDriver.refreshr#r9cF|jtjdS)a>Returns a set of dictionaries, corresponding to cookies visible in the current session. Returns: -------- cookies:List[dict] : A list of dictionaries, corresponding to cookies visible in the current Example: -------- >>> cookies = driver.get_cookies() r)rr)GET_ALL_COOKIESrs r: get_cookieszWebDriver.get_cookiess||G334W==r9c|r|jr tdtjt5|j t jd|idcdddS#1swYyxYw)zGet a single cookie by name. Raises ValueError if the name is empty or whitespace. Returns the cookie if found, None if not. Example: -------- >>> cookie = driver.get_cookie("my_cookie") Cookie name cannot be emptyrrN)isspace ValueError contextlibsuppressrrr) GET_COOKIErrs r: get_cookiezWebDriver.get_cookieset||~:; ;  !6 7 M<< 2 2VTNCGL M M Ms %A&&A/c|r|jr td|jtjd|iy)zDeletes a single cookie with the given name. Raises ValueError if the name is empty or whitespace. Example: -------- >>> driver.delete_cookie("my_cookie") r.rN)r/r0rr) DELETE_COOKIEr4s r: delete_cookiezWebDriver.delete_cookies3t||~:; ; W**VTN;r9cB|jtjy)zDelete all cookies in the scope of the session. Example: -------- >>> driver.delete_all_cookies() N)rr)DELETE_ALL_COOKIESrs r:delete_all_cookieszWebDriver.delete_all_cookiess W//0r9cd|vr,|ddvsJ|jtjd|iy|jtjd|iy)azAdds a cookie to your current session. Parameters: ----------- cookie_dict : dict - A dictionary object, with required keys - "name" and "value"; - Optional keys - "path", "domain", "secure", "httpOnly", "expiry", "sameSite" Examples: -------- >>> driver.add_cookie({"name": "foo", "value": "bar"}) >>> driver.add_cookie({"name": "foo", "value": "bar", "path": "/"}) >>> driver.add_cookie({"name": "foo", "value": "bar", "path": "/", "secure": True}) >>> driver.add_cookie({"name": "foo", "value": "bar", "sameSite": "Strict"}) sameSite)StrictLaxNonecookieN)rr) ADD_COOKIE)r cookie_dicts r: add_cookiezWebDriver.add_cookiesR  $z*.GG GG LL++h -D E LL++h -D Er9 time_to_waitc r|jtjdtt |dziy)aSets a sticky timeout to implicitly wait for an element to be found, or a command to complete. This method only needs to be called one time per session. To set the timeout for calls to execute_async_script, see set_script_timeout. Parameters: ----------- time_to_wait : float - Amount of time to wait (in seconds) Example: -------- >>> driver.implicitly_wait(30) implicitNrr) SET_TIMEOUTSintfloatrrEs r:implicitly_waitzWebDriver.implicitly_waits- W))JE,>> driver.set_script_timeout(30) rrHNrIrMs r:set_script_timeoutzWebDriver.set_script_timeout-s- W))Hc% :MPT:T6U+VWr9c  |jtjdtt |dziy#t $r2|jtjt |dzddYywxYw)a2Set the amount of time to wait for a page load to complete before throwing an error. Parameters: ----------- time_to_wait : float - The amount of time to wait (in seconds) Example: -------- >>> driver.set_page_load_timeout(30) pageLoadrHz page load)msrN)rr)rJrKrLrrMs r:set_page_load_timeoutzWebDriver.set_page_load_timeout<sf h LL-- Cl@SVZ@Z<[/\ ]! h LL--eL6ID6PZe/f g hs7:8A54A5c|jtjd}|jddz |d<|jddz |d<|jddz |d<t di|S) aGet all the timeouts that have been set on the current session. Returns: -------- Timeouts: A named tuple with the following fields: - implicit_wait: The time to wait for elements to be found. - page_load: The time to wait for a page to load. - script: The time to wait for scripts to execute. Example: -------- >>> driver.timeouts rrGrH implicit_waitrR page_loadrr8)rr) GET_TIMEOUTSrr)rtimeoutss r:rYzWebDriver.timeoutsNss<< 4 45g>$,LL$>> my_timeouts = Timeouts() >>> my_timeouts.implicit_wait = 10 >>> driver.timeouts = my_timeouts rN)rr)rJ_to_json)rrY_s r:rYzWebDriver.timeoutscs( LL--x/@/@/B CG Lr9rc|jj||\}}t|tr2|j ||}|st d|j |dS|jtj||ddS)aFind an element given a By strategy and locator. Parameters: ----------- by : selenium.webdriver.common.by.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. Example: -------- element = driver.find_element(By.ID, 'foo') Returns: ------- WebElement The first matching `WebElement` found on the page. )byrz%Cannot locate relative element with: rusingrr) rconvertr[r# find_elementsrrootrr) FIND_ELEMENT)rr^relementss r: find_elementzWebDriver.find_elementps4**222u= E b* %))Ru)=H,/TUWU\U\T]-^__A; ||G00B2OPQXYYr9c|jj||\}}t|trrdj t j ddd}tj|djd}d|d}|j||jS|jtj||dd xsgS) a Find elements given a By strategy and locator. Parameters: ----------- by : selenium.webdriver.common.by.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. Example: -------- element = driver.find_elements(By.ID, 'foo') Returns: ------- List[WebElement] list of `WebElements` matching locator strategy found on the page. rNzfindElements.jsutf8z/* findElements */return (z).apply(null, arguments);r_r)rrar[r#joinrysplitpkgutilget_datadecoderrrr) FIND_ELEMENTS)rr^r_pkg raw_functionfind_element_jss r:rbzWebDriver.find_elementss4**222u= E b* %88HNN3/45D"++D2CDKKFSL :<.HabO&& E E||G11R%3PQRYZ`^``r9c|jS)zReturns the drivers current capabilities being used. Example: -------- >>> print(driver.capabilities) )rCrs r:r=zWebDriver.capabilitiessyyr9c@t|jjdstjdt d|j } t|d5}|j|ddd~y#1swY xYw#t$rY~ywxYw#~wxYw) aSaves a screenshot of the current window to a PNG image file. Returns False if there is any IOError, else returns True. Use full paths in your filename. Parameters: ----------- filename : str - The full path you wish to save your screenshot to. This - should end with a `.png` extension. Example: -------- >>> driver.get_screenshot_as_file("/Screenshots/foo.png") z.pngz^name used for saved screenshot does not match file type. It should end with a `.png` extensionr$ stacklevelwbNFT) r\lowerendswithwarningswarn UserWarningget_screenshot_as_pngopenwriteOSError)rfilenamepngfs r:get_screenshot_as_filez WebDriver.get_screenshot_as_files8}""$--f5 MMp  ((* h%         s< B "A>4B >BB BBBBBc$|j|S)aSaves a screenshot of the current window to a PNG image file. Returns False if there is any IOError, else returns True. Use full paths in your filename. Parameters: ----------- filename : str - The full path you wish to save your screenshot to. This - should end with a `.png` extension. Example: -------- >>> driver.save_screenshot("/Screenshots/foo.png") )r)rrs r:save_screenshotzWebDriver.save_screenshots**844r9cRt|jjdS)zGets the screenshot of the current window as a binary data. Example: -------- >>> driver.get_screenshot_as_png() ascii)rget_screenshot_as_base64encoders r:r}zWebDriver.get_screenshot_as_pngs#668??HIIr9cF|jtjdS)zGets the screenshot of the current window as a base64 encoded string which is useful in embedded images in HTML. Example: -------- >>> driver.get_screenshot_as_base64() r)rr) SCREENSHOTrs r:rz"WebDriver.get_screenshot_as_base64s||G../88r9 windowHandlecp|j||jt|t|y)a]Sets the width and height of the current window. (window.resizeTo) Parameters: ----------- width : int - the width in pixels to set the window to height : int - the height in pixels to set the window to Example: -------- >>> driver.set_window_size(800, 600) widthheightN"_check_if_window_handle_is_currentset_window_rectrK)rrrrs r:set_window_sizezWebDriver.set_window_sizes- // = 3u:c&kBr9c|j||j}|jddr|d}dDcic]}||| c}Scc}w)zGets the width and height of the current window. Example: -------- >>> driver.get_window_size() rNr)rget_window_rectrV)rrsizerEs r:get_window_sizezWebDriver.get_window_sizesS // =##% 88GT "=D$78q47 888s A xycn|j||jt|t|S)aiSets the x,y position of the current window. (window.moveTo) Parameters: --------- x : float - The x-coordinate in pixels to set the window position y : float - The y-coordinate in pixels to set the window position Example: -------- >>> driver.set_window_position(0, 0) rrr)rrrrs r:set_window_positionzWebDriver.set_window_position)s0 // =##c!fA#77r9cv|j||j}dDcic]}||| c}Scc}w)zGets the x,y position of the current window. Example: -------- >>> driver.get_window_position() r)rr)rrpositionrEs r:get_window_positionzWebDriver.get_window_position;s< // ='')(2318A;333s 6c>|dk7rtjddyy)z5Warns if the window handle is not equal to `current`.currentz?Only 'current' window is supported for W3C compatible browsers.r$ruN)rzr{)rrs r:rz,WebDriver._check_if_window_handle_is_currentHs 9 $ MM[hi j %r9cF|jtjdS)zGets the x, y coordinates of the window as well as height and width of the current window. Example: -------- >>> driver.get_window_rect() r)rr)GET_WINDOW_RECTrs r:rzWebDriver.get_window_rectMrr9cx|||s |s td|jtj||||ddS)aSets the x, y coordinates of the window as well as height and width of the current window. This method is only supported for W3C compatible browsers; other browsers should use `set_window_position` and `set_window_size`. Example: -------- >>> driver.set_window_rect(x=10, y=10) >>> driver.set_window_rect(width=100, height=200) >>> driver.set_window_rect(x=10, y=10, width=100, height=200) z'x and y or height and width need values)rrrrr)rrr)SET_WINDOW_RECT)rrrrrs r:rzWebDriver.set_window_rectWsD I!)fU*+TU U||G3311u`f5ghipqqr9c|jSr)_file_detectorrs r:rzWebDriver.file_detectoris"""r9cb|s tdt|ts td||_y)a_Set the file detector to be used when sending keyboard input. By default, this is set to a file detector that does nothing. - see FileDetector - see LocalFileDetector - see UselessFileDetector Parameters: ----------- detector : Any - The detector to use. Must not be None. z,You may not set a file detector that is nullz+Detector has to be instance of FileDetectorN)rr[r,r)rdetectors r:rzWebDriver.file_detectorms1$%ST T(L1$%RS S&r9cF|jtjdS)zGets the current orientation of the device. Example: -------- >>> orientation = driver.orientation r)rr)GET_SCREEN_ORIENTATIONrs r: orientationzWebDriver.orientationrr9cddg}|j|vr#|jtjd|iyt d)zSets the current orientation of the device. Parameters: ----------- value : str - orientation to set it to. Example: -------- >>> driver.orientation = "landscape" LANDSCAPEPORTRAITrz>You can only set the orientation to 'LANDSCAPE' and 'PORTRAIT'N)upperrr)SET_SCREEN_ORIENTATIONr)rrallowed_valuess r:rzWebDriver.orientationsA&z2 ;;=N * LL77-9O P$%ef fr9cJ|jrt|jfStts|jj drI|jj d}|jj dj dd}n|j \}}|s tdtj|a|jdjdk(r tdt|_|jjtjj}|dj }|jjtjj#|d }||j_t|jfS) Nse:cdp se:cdpVersionrr2Unable to find url to connect to from capabilitiesrTfirefoxzJCDP support for Firefox has been removed. Please switch to WebDriver BiDi.T)rdevtoolsr;rCrVrk_get_cdp_detailsrr7import_devtoolsrx RuntimeErrorr5rtarget get_targets target_idattach_to_targetr)rws_urlversiontargetsrsessions r:start_devtoolszWebDriver.start_devtoolssH  % %T777 7 L99==*!YY]]84F"iimmO<BB3GJG&*&;&;&=OGV,-abb..w799]+113y@&'stt)E2 F E0FE2E2E2E- !E$"E- )E20F2F8E; 9FFc|js|j|jst|j|_|jSr)r _start_bidirrrs r:rzWebDriver.scripts:))    ||!$"<"<=DL||r9c|jjdr|jjd}n tdt||_y)N webSocketUrlr)rCrVrr5r)rrs r:rzWebDriver._start_bidis= 99== (YY]]>2F$%YZ Z%8%@"r9c|js|jt|dr |jt |j|_|jS)Nr)rrrrrrs r:networkzWebDriver.networksF))    tZ(DMM,A#D$>$>?DM}}r9c|js|j|jt|j|_|jS)aReturns a browser module object for BiDi browser commands. Returns: -------- Browser: an object containing access to BiDi browser commands. Examples: --------- >>> user_context = driver.browser.create_user_context() >>> user_contexts = driver.browser.get_user_contexts() >>> client_windows = driver.browser.get_client_windows() >>> driver.browser.remove_user_context(user_context) )rrrrrs r:browserzWebDriver.browsers?))     == #D$>$>?DM}}r9c|js|j|jt|j|_|jS)zT Returns the BiDi session object for the current WebDriver session. )rrrrrs r:_sessionzWebDriver._sessionsD ))        %!()C)C!DD !!!r9c|js|j|jt|j|_|jS)aReturns a browsing context module object for BiDi browsing context commands. Returns: -------- BrowsingContext: an object containing access to BiDi browsing context commands. Examples: --------- >>> context_id = driver.browsing_context.create(type="tab") >>> driver.browsing_context.navigate(context=context_id, url="https://www.selenium.dev") >>> driver.browsing_context.capture_screenshot(context=context_id) >>> driver.browsing_context.close(context_id) )rrrrrs r:browsing_contextzWebDriver.browsing_contextsD))      ! ! )%4T5O5O%PD "%%%r9c|js|j|jt|j|_|jS)a9Returns a storage module object for BiDi storage commands. Returns: -------- Storage: an object containing access to BiDi storage commands. Examples: --------- >>> cookie_filter = CookieFilter(name="example") >>> result = driver.storage.get_cookies(filter=cookie_filter) >>> driver.storage.set_cookie(cookie=PartialCookie( "name", BytesValue(BytesValue.TYPE_STRING, "value"), "domain") ) >>> driver.storage.delete_cookies(filter=CookieFilter(name="example")) )rrrrrs r:storagezWebDriver.storage%s?"))     == #D$>$>?DM}}r9c|js|j|jt|j|_|jS)aReturns a webextension module object for BiDi webextension commands. Returns: -------- WebExtension: an object containing access to BiDi webextension commands. Examples: --------- >>> extension_path = "/path/to/extension" >>> extension_result = driver.webextension.install(path=extension_path) >>> driver.webextension.uninstall(extension_result) )rrrrrs r: webextensionzWebDriver.webextension>sD))        %!-d.H.H!ID !!!r9cLddl}ddl}|j}|jj ddk(r+|jj dj d}nH|jj ddk(r*|jj dj d}|j dd d }|j |j}|j d }|j d }ddl} | jd |jd} | |fS)NrrTchromezgoog:chromeOptionsdebuggerAddress MicrosoftEdgezms:edgeOptionsrzhttp://z /json/versionrwebSocketDebuggerUrlz .*/(\d+)\.r&) jsonurllib3 PoolManagerrCrVrequestloadsdataresearchgroup) rrrhttpdebugger_addressresrbrowser_version websocket_urlrrs r:rzWebDriver._get_cdp_detailsTs""$ 99== '8 3#yy}}-ABFFGXY  YY]]= )_ <#yy}}-=>BBCTU ll5G,<+=]"KLzz#((#((9-!78 ))M?;AA!D %%r9cp|jtj|jd|_y)afAdds a virtual authenticator with the given options. Example: -------- >>> from selenium.webdriver.common.virtual_authenticator import VirtualAuthenticatorOptions >>> options = VirtualAuthenticatorOptions(protocol="u2f", transport="usb", device_id="myDevice123") >>> driver.add_virtual_authenticator(options) rN)rr)ADD_VIRTUAL_AUTHENTICATORrr)rres r:add_virtual_authenticatorz#WebDriver.add_virtual_authenticatorls-"&g.O.OQXQ`Q`Qb!cdk!lr9c|jS)zReturns the id of the virtual authenticator. Example: -------- >>> print(driver.virtual_authenticator_id) )rrs r:virtual_authenticator_idz"WebDriver.virtual_authenticator_idws%%%r9cj|jtjd|jid|_y)zRemoves a previously added virtual authenticator. The authenticator is no longer valid after removal, so no methods may be called. Example: -------- >>> driver.remove_virtual_authenticator() authenticatorIdN)rr)REMOVE_VIRTUAL_AUTHENTICATORrrs r:remove_virtual_authenticatorz&WebDriver.remove_virtual_authenticators, W99>> from selenium.webdriver.common.credential import Credential >>> credential = Credential(id="user@example.com", password="aPassword") >>> driver.add_credential(credential) rN)rr)ADD_CREDENTIALrr)rrs r:add_credentialzWebDriver.add_credentials6 W++-p 0B0B0D-pFWY]YoYo-pqr9c|jtjd|ji}|dDcgc]}t j |c}Scc}w)zReturns the list of credentials owned by the authenticator. Example: -------- >>> credentials = driver.get_credentials() rr)rr)GET_CREDENTIALSrr from_dict)rcredential_datars r:get_credentialszWebDriver.get_credentialssL,,w'>'>ARTXTjTj@klCRSZC[\Z $$Z0\\\sA credential_idct|trt|j}|j t j ||jdy)zRemoves a credential from the authenticator. Example: -------- >>> credential_id = "user@example.com" >>> driver.remove_credential(credential_id) ) credentialIdrN)r[ bytearrayrrnrr)REMOVE_CREDENTIALr)rrs r:remove_credentialzWebDriver.remove_credentialsD mY /-m<CCEM  % % Z^ZpZp'q r9c\|jtjd|jiy)zRemoves all credentials from the authenticator. Example: -------- >>> driver.remove_all_credentials() rN)rr)REMOVE_ALL_CREDENTIALSrrs r:remove_all_credentialsz WebDriver.remove_all_credentialss$ W336GI_I_5`ar9verifiedc^|jtj|j|dy)a4Sets whether the authenticator will simulate success or fail on user verification. Parameters: ----------- verified: True if the authenticator will pass user verification, False otherwise. Example: -------- >>> driver.set_user_verified(True) )risUserVerifiedN)rr)SET_USER_VERIFIEDr)rr s r:set_user_verifiedzWebDriver.set_user_verifieds$ W..DDZDZnv0wxr9c~d|jvr td|jtjddS)zRetrieves the downloadable files as a list of file names. Example: -------- >>> files = driver.get_downloadable_files() se:downloadsEnabledCYou must enable downloads in order to work with downloadable files.rnames)r=rrr)GET_DOWNLOADABLE_FILESrs r:get_downloadable_filesz WebDriver.get_downloadable_filess= !(9(9 9$%jk k||G::;GDWMMr9 file_nametarget_directorycd|jvr tdtjj |stj ||j tjd|idd}tj5}tjj||dz}t|d5}|jtj|dddt!j"|d 5}|j%|ddddddy#1swYBxYw#1swYxYw#1swYyxYw) aDownloads a file with the specified file name to the target directory. Parameters: ----------- file_name : str - The name of the file to download. target_directory : str - The path to the directory to save the downloaded file. Example: -------- >>> driver.download_file("example.zip", "/path/to/directory") rrrrcontentsz.ziprwNr)r=rospathexistsmakedirsrr) DOWNLOAD_FILEtempfileTemporaryDirectoryrjr~rbase64rzipfileZipFile extractall)rrrrtmp_dirzip_filefilezip_refs r: download_filezWebDriver.download_files !(9(9 9$%jk kww~~./ KK( )<< 5 5 7JKGTU_`  ( ( * 5gww||GY-?@Hh% 7 6++H56 73/ 57""#34 5  5 5 7 7 5 5  5 5s< 0D8:%D D8=D,D8 D) %D8,D5 1D88Ectd|jvr td|jtjy)zzDeletes all downloadable files. Example: -------- >>> driver.delete_downloadable_files() rrN)r=rrr)DELETE_DOWNLOADABLE_FILESrs r:delete_downloadable_filesz#WebDriver.delete_downloadable_filess0 !(9(9 9$%jk k W667r9c|jS)aReturns the Federated Credential Management (FedCM) dialog object for interaction. Returns: ------- FedCM: an object providing access to all Federated Credential Management (FedCM) dialog commands. Examples: -------- >>> title = driver.fedcm.title >>> subtitle = driver.fedcm.subtitle >>> dialog_type = driver.fedcm.dialog_type >>> accounts = driver.fedcm.account_list >>> driver.fedcm.select_account(0) >>> driver.fedcm.accept() >>> driver.fedcm.dismiss() >>> driver.fedcm.enable_delay() >>> driver.fedcm.disable_delay() >>> driver.fedcm.reset_cooldown() )rrs r:fedcmzWebDriver.fedcms,{{r9cV|jjtjdS)zReturns whether the browser supports FedCM capabilities. Example: -------- >>> print(driver.supports_fedcm) F)r=rVrFEDCM_CAPABILITYrs r:supports_fedcmzWebDriver.supports_fedcm s#  $$Z%@%@%HHr9c2|js tdy)z.Raises an exception if FedCM is not supported.znThis browser does not support Federated Credential Management. Please ensure you're using a supported browser.N)r1rrs r:_require_fedcm_supportz WebDriver._require_fedcm_support*s#""$B #r9c8|jt|S)zReturns the FedCM dialog object for interaction. Example: -------- >>> dialog = driver.dialog )r3r%rs r:dialogzWebDriver.dialog2s ##%d|r9cddlmddlm}j |f}fd||||}|j fdS)aWaits for and returns the FedCM dialog. Parameters: ----------- timeout : int - How long to wait for the dialog poll_frequency : floatHow - Frequently to poll ignored_exceptions : Any - Exceptions to ignore while waiting Returns: ------- The FedCM dialog object if found Raises: ------- TimeoutException if dialog doesn't appear WebDriverException if FedCM not supported r)NoAlertPresentException) WebDriverWaitcR t}|jr|SdS#$rYywxYwr)r%r)r5r7rs r: _check_fedcmz,WebDriver.fedcm_dialog.._check_fedcm\s4 !'v6$6*  s&&)poll_frequencyignored_exceptionscSrr8)r\r:s r:z(WebDriver.fedcm_dialog..ds LNr9)selenium.common.exceptionsr7selenium.webdriver.support.waitr8r3until)rtimeoutr;r<r8waitr7r:s` @@r: fedcm_dialogzWebDriver.fedcm_dialog=sO. GA ##%  %"9!;  T7>^pqzz233r9)zhttp://127.0.0.1:4444TNNNNNr)rLN)r)NNNN)g?N)ryrzr{r|r4rr2rrr\r0boolr r,rr r.rr(rrrr BaseExceptiontypes TracebackTyperrrpropertyr/rrrrrrrrrrr rrVrr1rrrrrrrrrr rrrrrrr3rr"r&r)r,r r5r8r;rDrLrNrPrTrrYsetterrIDrfrbr=rrrr}rrrrrrrrrrrrrrrrrrrrrrr!rrr"rr rrrrr rrrr)r,r+r.r1r3r5rDr8r9r:rrs " O:Q04CG8<*.04J"%5 56J"J" - J" % T+-> >?@ J" $$45 J""$J" -J" J"X`4 ./m $E//0 33< Lc L L  $4& 7S7Z7 \3\$\6KcK8DcN3KKW[\_ad\dWeK@0s0t0(@s@@ # #) # k kd k)DI)ZSZ8Z3Z,>S>>>S>>$ *LsLLES EE$0.B(>B#B 8*&)& >T$Z >(4. <1F.ZEZdZ" Xu X Xh%hDh$$($$(__ M M!eeD"ZHSM"ZZ"ZH "uuT$aXc]$ad:FV$aLd$>545"JuJ9#9C3CtC$9C99 8U8u8C8X\8$ 4T 4ksktk >>r$r$#|##''&EEgg$88==&A, " "&&,0""*&0 m1L mQU m&#&&$ &$ &$ r r r$ r$]j!1]$]$ uS)^/D  $ $b$b$ y$ y4 y$ y N N5s5c5d5@ 8u.III'4r9rr)fr|r!r1r@rrlrrHrzr"abcrrrrr importlibrtypingr r r r r rr?rrrrr&selenium.webdriver.common.bidi.browserr/selenium.webdriver.common.bidi.browsing_contextr&selenium.webdriver.common.bidi.networkr%selenium.webdriver.common.bidi.scriptr&selenium.webdriver.common.bidi.sessionr&selenium.webdriver.common.bidi.storager+selenium.webdriver.common.bidi.webextensionrselenium.webdriver.common.byr!selenium.webdriver.common.optionsrr,selenium.webdriver.common.print_page_optionsr"selenium.webdriver.common.timeoutsr/selenium.webdriver.common.virtual_authenticatorr r!r"+selenium.webdriver.support.relative_locatorr#common.fedcm.dialogr%rr'rKr(rr) errorhandlerr*r.r+rr,r-rr.rr/remote_connectionr0rr1 shadowrootr2rr3 webelementr4websocket_connectionr5r7rr;rGrr\rFrdrvrxrr8r9r:rcs<$$   /:#99;K:8::D+EE7 C(+'&://!""5  B O4-1 C!112  L)   6D-$Dgt4 t4r9