,h dZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddlm Z ddlm Z ddlmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlmZddlmZddlmZddlmZddl m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl*m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2ddl1m3Z3ddl1m4Z4dd l5m6Z6d!d"l7m8Z8d#d$l9m:Z:d#d%l;mZ>d#d'l?m@Z@d#d(lAmBZBd#d)lCmDZDd#d*lCmEZEd#d+lFmGZGd#d,lHmIZId#d-lJmKZKd#d.lLmMZMd#d/lNmOZOd#d0lPmQZQd#d1lRmSZSd#d2lTmUZUdaVdaWd3ZXd4ZY dCd5eZd6ee[eKfd7e\d8e\d9ee<d:eKf d;Z]dd?e @Z_GdAdBe_Z`y)DzThe WebDriver implementation.N)ABCMeta) b64decode)urlsafe_b64encode)asynccontextmanager)contextmanager) import_module)Dict)List)Optional)Type)Union)InvalidArgumentException)JavascriptException)NoSuchCookieException)NoSuchElementException)WebDriverException)Browser)BrowsingContext)Network)Script)Session)By) ArgOptions) BaseOptions) PrintOptions)Timeouts) Credential)VirtualAuthenticatorOptions)required_virtual_authenticator) RelativeBy)Dialog)BidiConnection) ClientConfig)Command) ErrorHandler)FedCM) FileDetector)LocalFileDetector)LocatorConverter)Mobile)RemoteConnection) ScriptKey) ShadowRoot)SwitchTo) WebElement)WebSocketConnectionc(ts tdayy)Nz"selenium.webdriver.common.bidi.cdp)cdpre/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/selenium/webdriver/remote/webdriver.py import_cdpr8Ts @A r6cztj|}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 r7 _create_capsrDZsK == DL 1 Q B4 M NNr6r: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)rHr)ChromeRemoteConnection)EdgeRemoteConnection)FirefoxRemoteConnection)SafariRemoteConnectionc3`K|]%}|jjdk(s"|'yw) browserNameN) browser_nameget).0cr:s r7 z(get_remote_connection..s(_!Q^^|?O?OP]?^-^A_s#..)rKrF ignore_proxyrH) isinstancestrr%rKr-+selenium.webdriver.chrome.remote_connectionrL)selenium.webdriver.edge.remote_connectionrM,selenium.webdriver.firefox.remote_connectionrN+selenium.webdriver.safari.remote_connectionrOnext) r:rErFrGrHrLrMrNrO candidateshandlers ` r7get_remote_connectionraos|"C(%ZIY)Z +; (+-HRNTR(*>@VXopJ_z_aqrG +'#  r6optionscdii}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_capabilitieslenrangekeysupdater?) rbr:optsopt opts_sizesamesiesi min_index first_keyskysalwaysrBrCs r7create_matchesrssW"B'L D+ C'')*+D IH9 E q59 i--/J! E$q1u+**,,Is+tAE{3/?? d9oc.B(CD E EF 1q  A! 39L /15L . r6ceZdZdZy) 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__r5r6r7rurusr6ru) 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#d e#fd"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*Z/d+Z0d&e fd,Z1ed e fd-Z2ed e fd.Z3d}d/Z4d}d0Z5ed e fd1Z6ed ee fd2Z7d}d3Z8d}d4Z9d}d5Z:d|d6e e;d e fd7Zd}d9Z?d}d:Z@d}d;ZAd ee#fd<ZBd e eCfd=ZDd}d>ZEd}d?ZFd}d@ZGdAeHd dfdBZIdAeHd dfdCZJdAeHd dfdDZKed eLfdEZMeMjd}dFZMeOjdfdGe e d efdHZQeOjdfdGe e d eefdIZRed e#fdJZSd e fdKZTd e fdLZUd eVfdMZWd e fdNZXd~dOe d dfdPZYd~dOe d e#fdQZZd~dReHdSeHdOe d e#fdTZ[d~d e#fdUZ\dOe d dfdVZ]d e#fdWZ^dd e#fdXZ_ed e fdYZ`e`jd}dZZ`ed[Zaeajd}d\Zad]Zbecd^Zded_Zed`ZfedaZgedbZhedcZieddZjdeZkdeld dfdfZmed e fdgZneod}dhZpeodieqd dfdjZreod eeqfdkZseodlee etfd dfdmZueod}dnZveodoe d dfdpZwd exfdqZydre dse d dfdtZzd}duZ{ed e|fdvZ}ed e fdwZ~dxZedyZddzZy) 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. NrErF file_detectorrblocator_converterweb_element_clsrHrIc| 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|_#y)aVCreate 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)rErFrGrHT)$ TypeErrorrXlistrsre_ignore_local_proxyrErYbytesra _is_remote session_idr@pinned_scriptsr' error_handlerr0 _switch_tor,_mobiler*r}r+r~_web_element_cls_authenticator_id start_client start_sessionr(_fedcm_websocket_connection_script_network_browser _bidi_session_browsing_context) selfrErFr}rbr~rrHr:rs r7__init__zWebDriver.__init__sV@ ?r  &)'2L"' "224L")"="=  0 d++c5\ :$9!1%#6+ %D !  )^"4.d| *A.?.A!2!H6F6H / H43H3H!%  <(Dk %)"   !!%r6czdt|jdt|jd|jdS)N<.z (session="z")>)typerwrvrrs r7__repr__zWebDriver.__repr__s94:(()4:+>+>*?{4??J[[^__r6c|SNr5rs r7 __enter__zWebDriver.__enter__s r6exc_typeexc tracebackc$|jyr)quit)rrrrs r7__exit__zWebDriver.__exit__s r6c/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)rXr})rfile_detector_classargskwargs last_detectors r7file_detector_contextzWebDriver.file_detector_contextsc* $,,.AB ..M!4d!Ef!ED  3 %2"}%2"s2AA A AAc|jSr)rrs r7mobilezWebDriver.mobile;s ||r6cRd|jvr|jdStd)zReturns the name of the underlying browser for this instance. Example: -------- >>> name = driver.name rQz1browserName not specified in session capabilities)r@KeyErrorrs r7namezWebDriver.name?s+ DII %99]+ +JKKr6cy)zxCalled before starting a new session. This method may be overridden to define custom startup behavior. Nr5rs r7rzWebDriver.start_clientKs r6cy)zCalled after executing a quit command. This method may be overridden to define custom shutdown behavior. Nr5rs r7 stop_clientzWebDriver.stop_clientRs r6r: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) rDexecuter& NEW_SESSIONrSrr@ Exceptionhasattrrstop)rr:r@responses r7rzWebDriver.start_sessionZsL) ||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_valuerTitemrs r7rVz(WebDriver._wrap_value..xsA4((.A)rXdictr?rrid_shadowroot_clsr)rr convertedkeyvals` r7rzWebDriver._wrap_valuems eT "I!KKM 7S!%!1!1#!6 # 7  eT22 39588D D eT11 28%((C C eT "A5AA A r6 element_idc&|j||S)z6Creates a web element with the specified `element_id`.)r)rrs r7create_web_elementzWebDriver.create_web_element{s$$T:66r6c.t|tr_d|vrj|dSd|vrj|dS|j D]\}}j |||<|St|t rt fd|DS|S)Nrrc3@K|]}j|ywr) _unwrap_valuers r7rVz*WebDriver._unwrap_value..sCT**40Cr)rXrrrr?rr)rrrrs` r7rzWebDriver._unwrap_values eT "4=..u5Z/[\\3u<++D%8\2]^^!KKM 5S!//4c  5L eT "CUCC C r6cmdcmd_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 r7execute_cdp_cmdzWebDriver.execute_cdp_cmds!2||/1QRSZ[[r6driver_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)rrrErrcheck_responserrS)rrrrs r7rzWebDriver.executes!!&) ??%t7F*&*oo{#((00H     - -h 7 $ 2 28<<3N OHW Ot$//JJr6urlcH|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 r7rSz WebDriver.gets$ W[[5#,/r6c`|jtjjddS)zReturns the title of the current page. Example: -------- >>> element = driver.find_element(By.ID, 'foo') >>> print(element.title()) r)rr& GET_TITLErSrs r7titlezWebDriver.titles&||G--.227B??r6scriptcNt|}||j|j<|S)zStore common javascript scripts to be executed later by a unique hashable ID. Example: -------- >>> script = "return document.getElementById('foo').value" )r.rr)rr script_keyscript_key_instances r7 pin_scriptzWebDriver.pin_scripts,( 36</223""r6rc |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 r7unpinzWebDriver.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 r7get_pinned_scriptszWebDriver.get_pinned_scriptssD''((r6ct|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) rXr.rrrrrr&W3C_EXECUTE_SCRIPTrrrrconverted_argscommands r7execute_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 r7execute_async_scriptzWebDriver.execute_async_script%s4"d22||G%OPQXYYr6cF|jtjdS)zsGets the URL of the current page. Example: -------- >>> print(driver.current_url) r)rr&GET_CURRENT_URLrs r7 current_urlzWebDriver.current_url;||G334W==r6cF|jtjdS)zvGets the source of the current page. Example: -------- >>> print(driver.page_source) r)rr&GET_PAGE_SOURCErs r7 page_sourcezWebDriver.page_sourceErr6cB|jtjy)zaCloses the current window. Example: -------- >>> driver.close() N)rr&CLOSErs r7closezWebDriver.closeOs W]]#r6c |jtj|j|jj y#|j|jj wxYw)zzQuits the driver and closes every associated window. Example: -------- >>> driver.quit() N)rr&QUITrrErrs r7rzWebDriver.quitXsW * 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 r7current_window_handlezWebDriver.current_window_handlees||GAAB7KKr6cF|jtjdS)zReturns the handles of all windows within the current session. Example: -------- >>> print(driver.window_handles) r)rr&W3C_GET_WINDOW_HANDLESrs r7window_handleszWebDriver.window_handleso||G::;GDDr6cHtj}|j|dy)zMaximizes the current window that webdriver is using. Example: -------- >>> driver.maximize_window() N)r&W3C_MAXIMIZE_WINDOWr)rrs r7maximize_windowzWebDriver.maximize_windowys-- Wd#r6cB|jtjy)zInvokes the window manager-specific 'full screen' operation. Example: -------- >>> driver.fullscreen_window() N)rr&FULLSCREEN_WINDOWrs r7fullscreen_windowzWebDriver.fullscreen_windows W../r6cB|jtjy)z9Invokes the window manager-specific 'minimize' operation.N)rr&MINIMIZE_WINDOWrs r7minimize_windowzWebDriver.minimize_windows W,,-r6 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)rrrbs r7 print_pagezWebDriver.print_pages6 #++-G||G..8AAr6c|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 r7 switch_tozWebDriver.switch_tos&r6cB|jtjy)ztGoes one step backward in the browser history. Example: -------- >>> driver.back() N)rr&GO_BACKrs r7backzWebDriver.back W__%r6cB|jtjy)zvGoes one step forward in the browser history. Example: -------- >>> driver.forward() N)rr& GO_FORWARDrs r7forwardzWebDriver.forwards W''(r6cB|jtjy)zdRefreshes the current page. Example: -------- >>> driver.refresh() N)rr&REFRESHrs r7refreshzWebDriver.refreshrr6cF|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 r7 get_cookieszWebDriver.get_cookiess||G334W==r6c|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 r7 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*r+rr& DELETE_COOKIEr/s r7 delete_cookiezWebDriver.delete_cookies3t||~:; ; W**VTN;r6cB|jtjy)zDelete all cookies in the scope of the session. Example: -------- >>> driver.delete_all_cookies() N)rr&DELETE_ALL_COOKIESrs r7delete_all_cookieszWebDriver.delete_all_cookiess W//0r6cd|vr,|ddvsJ|jtjd|iy|jtjd|iy)aAdds 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 r7 add_cookiezWebDriver.add_cookiesO  $z*.GG G LL++h -D E LL++h -D Er6 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_TIMEOUTSintfloatrr@s r7implicitly_waitzWebDriver.implicitly_waits- W))JE,>> driver.set_script_timeout(30) rrCNrDrHs r7set_script_timeoutzWebDriver.set_script_timeout0s- W))Hc% :MPT:T6U+VWr6c  |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) pageLoadrCz page load)msrN)rr&rErFrGrrHs r7set_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 rrBrC implicit_waitrM page_loadrr5)rr& GET_TIMEOUTSrr)rtimeoutss r7rTzWebDriver.timeoutsQss<< 4 45g>$,LL$>> my_timeouts = Timeouts() >>> my_timeouts.implicit_wait = 10 >>> driver.timeouts = my_timeouts rN)rr&rE_to_json)rrT_s r7rTzWebDriver.timeoutsfs( LL--x/@/@/B CG Lr6rc|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) r~convertrXr find_elementsrrootrr& FIND_ELEMENT)rrYrelementss r7 find_elementzWebDriver.find_elementss4**222u= E b* %))Ru)=H,/TUWU\U\T]-^__A; ||G00B2OPQXYYr6c|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);rZr)r~r\rXr joinrvsplitpkgutilget_datadecoderrrr& FIND_ELEMENTS)rrYr_pkg raw_functionfind_element_jss r7r]zWebDriver.find_elementss4**222u= E b* %88HNN3/45D"++D2CDKKFSL :<.HabO&& E E||G11R%3PQRYZ`^``r6c|jS)zReturns the drivers current capabilities being used. Example: -------- >>> print(driver.capabilities) )r@rs r7r:zWebDriver.capabilitiessyyr6c@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) rYlowerendswithwarningswarn UserWarningget_screenshot_as_pngopenwriteOSError)rfilenamepngfs r7get_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)rr|s r7save_screenshotzWebDriver.save_screenshots**844r6cRt|jjdS)zGets the screenshot of the current window as a binary data. Example: -------- >>> driver.get_screenshot_as_png() ascii)rget_screenshot_as_base64encoders r7rxzWebDriver.get_screenshot_as_pngs#668??HIIr6cF|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 r7rz"WebDriver.get_screenshot_as_base64s||G../88r6 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_rectrF)rrrrs r7set_window_sizezWebDriver.set_window_size s- // = 3u:c&kBr6c|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_rectrS)rrsizerBs r7get_window_sizezWebDriver.get_window_sizesS // =##% 88GT "=D$78q47 888s A xycn|j||jt|t|S)ahSets 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 r7set_window_positionzWebDriver.set_window_position,s0 // =##c!fA#77r6cv|j||j}dDcic]}||| c}Scc}w)zGets the x,y position of the current window. Example: -------- >>> driver.get_window_position() r)rr)rrpositionrBs r7get_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!rpN)rurv)rrs r7rz,WebDriver._check_if_window_handle_is_currentKs 9 $ MM[hi j %r6cF|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 r7rzWebDriver.get_window_rectPrr6cx|||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 r7rzWebDriver.set_window_rectZsD I!)fU*+TU U||G3311u`f5ghipqqr6c|jSr)_file_detectorrs r7r}zWebDriver.file_detectorls"""r6cb|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)rrXr)r)rdetectors r7r}zWebDriver.file_detectorps1$%ST T(L1$%RS S&r6cF|jtjdS)zGets the current orientation of the device. Example: -------- >>> orientation = driver.orientation r)rr&GET_SCREEN_ORIENTATIONrs r7 orientationzWebDriver.orientationr r6cddg}|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 r7rzWebDriver.orientationsA&z2 ;;=N * LL77-9O P$%ef fr6cJ|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 capabilitiesrQfirefoxzJCDP support for Firefox has been removed. Please switch to WebDriver BiDi.T)rdevtoolsr8r@rSrf_get_cdp_detailsrr4import_devtoolsrs RuntimeErrorr2rtarget get_targets target_idattach_to_targetr)rws_urlversiontargetsrsessions r7start_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 r7rzWebDriver.scripts:))    ||!$"<"<=DL||r6c|jjdr|jjd}n tdt||_y)N webSocketUrlr)r@rSrr2r)rrs r7rzWebDriver._start_bidis= 99== (YY]]>2F$%YZ Z%8%@"r6c|js|jt|dr |jt |j|_|jS)Nr)rrrrrrs r7networkzWebDriver.networksF))    tZ(DMM,A#D$>$>?DM}}r6c|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 r7browserzWebDriver.browsers?))     == #D$>$>?DM}}r6c|js|j|jt|j|_|jS)zT Returns the BiDi session object for the current WebDriver session. )rrrrrs r7_sessionzWebDriver._sessionsD ))        %!()C)C!DD !!!r6c|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 r7browsing_contextzWebDriver.browsing_contextsD))      ! ! )%4T5O5O%PD "%%%r6cLddl}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)NrrQchromezgoog:chromeOptionsdebuggerAddress MicrosoftEdgezms:edgeOptionsrzhttp://z /json/versionrwebSocketDebuggerUrlz .*/(\d+)\.r#) jsonurllib3 PoolManagerr@rSrequestloadsdataresearchgroup) rrrhttpdebugger_addressresrbrowser_version websocket_urlrrs r7rzWebDriver._get_cdp_details(s""$ 99== '8 3#yy}}-ABFFGXY  YY]]= )_ <#yy}}-=>BBCTU ll5G,<+=]"KLzz#((#((9-!78 ))M?;AA!D %%r6cp|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)rrbs r7add_virtual_authenticatorz#WebDriver.add_virtual_authenticator@s-"&g.O.OQXQ`Q`Qb!cdk!lr6c|jS)zReturns the id of the virtual authenticator. Example: -------- >>> print(driver.virtual_authenticator_id) )rrs r7virtual_authenticator_idz"WebDriver.virtual_authenticator_idKs%%%r6cj|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 r7remove_virtual_authenticatorz&WebDriver.remove_virtual_authenticatorUs, 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 r7add_credentialzWebDriver.add_credentialcs6 W++-p 0B0B0D-pFWY]YoYo-pqr6c|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 r7get_credentialszWebDriver.get_credentialsosL,,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)rX bytearrayrrirr&REMOVE_CREDENTIALr)rrs r7remove_credentialzWebDriver.remove_credentialzsD mY /-m<CCEM  % % Z^ZpZp'q r6c\|jtjd|jiy)zRemoves all credentials from the authenticator. Example: -------- >>> driver.remove_all_credentials() rN)rr&REMOVE_ALL_CREDENTIALSrrs r7remove_all_credentialsz WebDriver.remove_all_credentialss$ W336GI_I_5`ar6verifiedc^|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)rrs r7set_user_verifiedzWebDriver.set_user_verifieds$ W..DDZDZnv0wxr6c~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 r7get_downloadable_filesz WebDriver.get_downloadable_filess= !(9(9 9$%jk k||G::;GDWMMr6 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.ziprrNr)r:rospathexistsmakedirsrr& DOWNLOAD_FILEtempfileTemporaryDirectoryreryrzbase64rzipfileZipFile extractall)rr r rtmp_dirzip_filefilezip_refs r7 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 r7delete_downloadable_filesz#WebDriver.delete_downloadable_filess0 !(9(9 9$%jk k W667r6c|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 r7fedcmzWebDriver.fedcms,{{r6cV|jjtjdS)zReturns whether the browser supports FedCM capabilities. Example: -------- >>> print(driver.supports_fedcm) F)r:rSrFEDCM_CAPABILITYrs r7supports_fedcmzWebDriver.supports_fedcms#  $$Z%@%@%HHr6c2|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)r(rrs r7_require_fedcm_supportz WebDriver._require_fedcm_supports#""$B #r6c8|jt|S)zReturns the FedCM dialog object for interaction. Example: -------- >>> dialog = driver.dialog )r*r"rs r7dialogzWebDriver.dialogs ##%d|r6cddlmddlm}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)r,r.rs r7 _check_fedcmz,WebDriver.fedcm_dialog.._check_fedcm0s4 !'v6$6*  s&&)poll_frequencyignored_exceptionscSrr5)rWr1s r7z(WebDriver.fedcm_dialog..8s LNr6)selenium.common.exceptionsr.selenium.webdriver.support.waitr/r*until)rtimeoutr2r3r/waitr.r1s` @@r7 fedcm_dialogzWebDriver.fedcm_dialogsO. GA ##%  %"9!;  T7>^pqzz233r6)zhttp://127.0.0.1:4444TNNNNNr)rIN)r)NNNN)g?N)rvrwrxryr1rr/rr rYr-boolr r)rr r+rr%rrrr BaseExceptiontypes TracebackTyperrrpropertyr,rrrrrrrrrrrrSrr.rrrrrrrrrrr r rrrrr0rrr!r$r'r r0r3r6r?rGrIrKrOrrTsetterrIDrar]r:rrrrxrrrrrrrrr}rrrrrrrrrrrrrrrrrrrrrrrrr r r#r(r%r(r*r,r;r5r6r7r|r|sG " O:Q04CG8<*.04G&%5 56G&G& - G& % T+-> >?@ G& $$45 G&"$G& -G& G&R`4 ./m $E//0 33< Lc L L  $4& 7S7Z7 \3\$\6KcK4K4K@0s0t0(@s@@ # #) # k kd k)DI)Z<Z3Z,>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 m1L mQU m&#&&$ &$ &$ r r r$ r$]j!1]$]$ uS)^/D  $ $b$b$ y$ y4 y$ y N N5s5c5d5@ 8u.III'4r6r|r)aryrr,r=rrgrr?rurabcrrrrr importlibrtypingr r r r r r6rrrrr&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.sessionrselenium.webdriver.common.byr!selenium.webdriver.common.optionsrr,selenium.webdriver.common.print_page_optionsr"selenium.webdriver.common.timeoutsr/selenium.webdriver.common.virtual_authenticatorrrr+selenium.webdriver.support.relative_locatorr common.fedcm.dialogr"rr$rHr%rr& errorhandlerr'r%r(r}r)r*r~r+rr,remote_connectionr-rr. shadowrootr/rr0 webelementr1websocket_connectionr2r4rr8rDrrYr=rarsrur|r5r6r7rXsO$$   $*%#?:<=9:K:8:+89E7FWC(+'&',//!""5  B O4-1 C!112  L)   6D-$DgD4 D4r6