cQbjdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZddlmZmZddlmZddlmZmZddlmZdd lmZmZmZdd lmZdd lmZm Z m!Z!m"Z"m#Z#dd l$m%Z%dd l&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5ddl6m7Z7ddl8m9Z9ddl:m;Z;mZ>ddl?m@Z@ddlAmBZBddlCmDZDddlEmFZFddlGmHZHmIZIddlJmKZKddlLmMZMdd lNmOZOdd!lPmQZQdd"lRmSZSdd#lTmUZUdd$lVmWZWdd%lXmYZYdd&lZm[Z[da\d7d'Z]d8d(Z^ d9 d:d)Z_d;d*Z`er dd+lambZbdd,lcmdZddd-lemfZfdd.lgmhZhdd/limjZjmkZkd0Zld1ZmGd2d3e4ZnGd5d6enZoy)lowerselfargskwargsfuncs r5wrapperz1_required_chromium_based_browser..wrappersEyy'--/7LL B LD*4*6**r4) functoolswrapsrrs` r5 _required_chromium_based_browserrs%__T++ Nr4cTtjtfd}|S)NcJ|js td|g|i|S)Nz9This function requires a virtual authenticator to be set.)virtual_authenticator_id ValueErrorrs r5rz0_required_virtual_authenticator..wrappers/,,XY YD*4*6**r4)rrrrs` r5_required_virtual_authenticatorrs-__T%+&+ Nr4ceZdZdZy) 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__r3r4r5rrsr4r) metaclasscReZdZdZeZeZ dc dddZdedZ dfdZ dgdZ e dZ edhdZeded Zdid Zdid Zdjd Zd ZdkdZdZdldZ dm dndZdodZededZdmdpdZdqdZdrdZdsdZdsdZededZ ededZ!didZ"didZ#ededZ$edrdZ%didZ&did Z'did!Z(dmdtd"Z)edud#Z*did$Z+did%Z,did&Z-dvd'Z.dwd(Z/did)Z0did*Z1did+Z2dxd,Z3dxd-Z4dxd.Z5edyd/Z6e6jndid0Z6e8jrdfdzd1Z:e8jrdfd{d2Z;ed|d3Zd~d6Z?ded7Z@ddd8ZAddd9ZBddd:ZCdd|d;ZDdd<ZEd|d=ZFdd|d>ZGedd?ZHeHjndid@ZHed|dAZIeIjndidBZIddCZJeKdDZLeddEZMdidFZNeddGZOeddHZPeddIZQeddJZReddKZSeddLZTeddMZUeddNZVeddOZWeddPZXdQZYddRZZeddSZ[e\didTZ]e\ddUZ^e\ddVZ_e\ddWZ`e\didXZae\ddYZbddZZcdd[Zddid\Zedmdd]Zfedd^Zged}d_Zhdid`ZieddaZjddbZky) WebDriveraControl a browser by sending commands to a remote WebDriver server. This class expects the remote server 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. Nc<| 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|_%d|_&d|_'d|_(d|_)d|_*y)aCreate a new driver instance that issues commands using the WebDriver protocol. Args: command_executor: 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: (Deprecated) Whether to configure remote_connection.RemoteConnection to use HTTP keep-alive. Defaults to True. file_detector: Pass a custom file detector object during instantiation. If None, the default LocalFileDetector() will be used. options: Instance of a driver options.Options class. locator_converter: Custom locator converter to use. Defaults to None. web_element_cls: Custom class to use for web elements. Defaults to WebElement. client_config: Custom client configuration to use. Defaults to None. Nz`missing 1 required keyword-only argument: 'options' (instance of driver `options.Options` class)F)r[rQr\rET)+ TypeErrorrSlistrsrc_ignore_local_proxyr[rTbytesr_ _is_remote session_idr>pinned_scriptsr$ error_handlerr- _switch_tor)_mobiler' file_detectorr(locator_converter_web_element_cls_authenticator_id start_client start_sessionr%_fedcm_websocket_connection_script_network_browser _bidi_session_browsing_context_storage _webextension _permissions _emulation_input_request _devtools) rr[rQrrhrweb_element_clsrEr8rs r5__init__zWebDriver.__init__s8 ?r  &)'2L"' "224L")"="=  0 d++c5\ :$9!1%#6+ %D !&*$& .0)^"4.d| *A.?.A!2!H6F6H / H43H3H!%  <(Dk AE"&* (, (, -19=(, 2604,0$( 26 %)r4czdt|jdt|jd|jdS)N<.z (session="z")>)typerrrrs r5__repr__zWebDriver.__repr__=s94:(()4:+>+>*?{4??J[[^__r4c|SNr3rs r5 __enter__zWebDriver.__enter__@s r4c$|jyr)quit)rexc_typeexc tracebacks r5__exit__zWebDriver.__exit__Cs r4c/Kd}t|j|s|j}||i||_ d|r||_yy#|r||_wwxYww)aBOverride the current file detector temporarily within a limited context. Ensures the original file detector is set after exiting the context. Args: file_detector_class: 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: Optional arguments that get passed to the file detector class during instantiation. **kwargs: Keyword arguments, passed the same way as args. Example: ``` with webdriver.file_detector_context(UselessFileDetector): someinput.send_keys("/etc/hosts") ```` N)rSr)rfile_detector_classrr last_detectors r5file_detector_contextzWebDriver.file_detector_contextKsc* $,,.AB ..M!4d!Ef!ED  3 %2"}%2"s2AA A AAc|jSr)rrs r5mobilezWebDriver.mobilejs ||r4cRd|jvr|jdStd)z=Returns the name of the underlying browser for this instance.rFz1browserName not specified in session capabilities)r>KeyErrorrs r5namezWebDriver.namens+ DII %99]+ +JKKr4cy)zxCalled before starting a new session. This method may be overridden to define custom startup behavior. Nr3rs r5rzWebDriver.start_clientus r4cy)zCalled after executing a quit command. This method may be overridden to define custom shutdown behavior. Nr3rs r5 stop_clientzWebDriver.stop_client|s r4c:t|} |jtj|d}|j d|_|j d|_y#t$r4t|dr&|j|jjwxYw)zCreates a new session with the desired capabilities. Args: capabilities: A capabilities dict to start the session with. value sessionIdr8serviceN) rBexecuter# NEW_SESSIONrUrr> ExceptionrZrstop)rr8r>responses r5rzWebDriver.start_sessions L) ||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_value.0itemrs r5 z(WebDriver._wrap_value..sA4((.A)rSdictr=rrid_shadowroot_clsr)rr convertedkeyvals` r5rzWebDriver._wrap_values eT "I!KKM 7S!%!1!1#!6 # 7  eT22 39588D D eT11 28%((C C eT "A5AA A r4c&|j||S)z6Creates a web element with the specified `element_id`.)r)r element_ids r5create_web_elementzWebDriver.create_web_elements$$T:66r4c.t|tr_d|vrj|dSd|vrj|dS|j D]\}}j |||<|St|t rt fd|DS|S)Nrrc3@K|]}j|ywr) _unwrap_valuers r5rz*WebDriver._unwrap_value..sCT**40Cr)rSrrrr=rr)rrrrs` r5rzWebDriver._unwrap_values eT "4=..u5Z/[\\3u<++D%8\2]^^!KKM 5S!//4c  5L eT "CUCC C r4c2|jd||ddS)aExecute Chrome Devtools Protocol command and get returned result. The command and command args should follow chrome devtools protocol domains/commands: - https://chromedevtools.github.io/devtools-protocol/ Args: cmd: Command name. cmd_args: 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)cmdparamsr)r)rrcmd_argss r5execute_cdp_cmdzWebDriver.execute_cdp_cmds!$||/1QRSZ[[r4c2tj|rE|js|j|jJ|jj |S|j |}|j r$|sd|j i}nd|vr|j |d<tt|jj ||}|rA|jj||j|jdd|d<|Sdd|j dS)aSends a command to be executed by a command.CommandExecutor. Args: driver_command: The name of the command to execute as a string. Can also be a BiDi protocol command generator. params: A dictionary of named parameters to send with the command. Ignored when ``driver_command`` is a BiDi generator. Returns: The command's JSON response loaded into a dictionary object. Nrrr)successrr)inspect isgeneratorr _start_bidirrrr r*r[rcheck_responserrU)rdriver_commandrrs r5rzWebDriver.executes"   ~ .--  "--9 99--55nE E!!&) ??%t7F*&*oo{#($*?*?@HHY_`     - -h 7 $ 2 28<<3N OHW Ot$//JJr4cH|jtjd|iy)aNavigate the browser to the specified URL. The method does not return until the page is fully loaded (i.e. the onload event has fired) in the current window or tab. Args: url: The URL to be opened by the browser. Must include the protocol (e.g., http://, https://). Example: `driver.get("https://example.com")` urlN)rr#GET)rrs r5rUz WebDriver.gets W[[5#,/r4c`|jtjjddS)zReturns the title of the current page. Example: ``` element = driver.find_element(By.ID, "foo") print(element.title()) ``` r)rr# GET_TITLErUrs r5titlezWebDriver.titles&||G--.227B??r4ctjdtdt|}||j|j <|S)aStore a JavaScript script by a unique hashable ID for later execution. .. deprecated:: Use ``driver.script.pin()`` instead, which uses the WebDriver BiDi protocol. Example: `script = "return document.getElementById('foo').value"` z9pin_script is deprecated, use driver.script.pin() instead stacklevel)warningswarnDeprecationWarningr+rr)rscript script_keyscript_key_instances r5 pin_scriptzWebDriver.pin_scriptsC  G  ( 36</223""r4ctjdtd |jj |j y#t $rt d|d|jdwxYw)zRemove a pinned script from storage. .. deprecated:: Use ``driver.script.unpin()`` instead, which uses the WebDriver BiDi protocol. Example: `driver.unpin(script_key)` z6unpin is deprecated, use driver.script.unpin() insteadrr zNo script with key: z existed in N)r r r rpoprr)rrs r5unpinzWebDriver.unpin sk  D   k    # #JMM 2 k1*\$J]J]I^_`fj j ks %A&A*cdtjdtdt|jS)zReturn a list of all pinned scripts. .. deprecated:: Use ``driver.script.pin()`` to manage preload scripts via the WebDriver BiDi protocol. Example: `pinned_scripts = driver.get_pinned_scripts()` z[get_pinned_scripts is deprecated, use driver.script.pin() to manage preload scripts insteadrr )r r r rrrs r5get_pinned_scriptszWebDriver.get_pinned_scripts3s,  i  D''((r4ct|tr |j|j}t |}tj}|j|||ddS#t$r t dwxYw)aSynchronously Executes JavaScript in the current window/frame. Args: script: The javascript to execute. *args: Any applicable arguments for your JavaScript. Example: ``` id = "username" value = "test_user" driver.execute_script("document.getElementById(arguments[0]).value = arguments[1];", id, value) ``` z Pinned script could not be foundrrr) rSr+rrrrrr#W3C_EXECUTE_SCRIPTrrrrconverted_argscommands r5execute_scriptzWebDriver.execute_scriptCsy fi ( N,,VYY7d,,||G%OPQXYY  N)*LMM Ns AA3cht|}tj}|j|||ddS)aAsynchronously Executes JavaScript in the current window/frame. Args: script: The javascript to execute. *args: 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 r5execute_async_scriptzWebDriver.execute_async_script\s4d22||G%OPQXYYr4cF|jtjdS)z!Gets the URL of the current page.r)rr#GET_CURRENT_URLrs r5 current_urlzWebDriver.current_urlo||G334W==r4cF|jtjdS)z$Gets the source of the current page.r)rr#GET_PAGE_SOURCErs r5 page_sourcezWebDriver.page_sourcetr$r4cB|jtjy)zCloses the current window.N)rr#CLOSErs r5closezWebDriver.closeys W]]#r4cD |j!|jjd|_|jtj|j !|j j d|_|jtt|j}|jy#|j !|j j d|_|jtt|j}|jwxYw)z4Quits the driver and closes every associated window.N) rr*rr#QUITrdisposerr r*r[)rexecutors r5rzWebDriver.quit}s ))5**002-1* LL &}}( %%' $    ,d.C.CDH NN  }}( %%' $    ,d.C.CDH NN s A B66A)DcF|jtjdS)z)Returns the handle of the current window.r)rr#W3C_GET_CURRENT_WINDOW_HANDLErs r5current_window_handlezWebDriver.current_window_handles||GAAB7KKr4cF|jtjdS)z>Returns the handles of all windows within the current session.r)rr#W3C_GET_WINDOW_HANDLESrs r5window_handleszWebDriver.window_handless||G::;GDDr4cHtj}|j|dy)z5Maximizes the current window that webdriver is using.N)r#W3C_MAXIMIZE_WINDOWr)rrs r5maximize_windowzWebDriver.maximize_windows-- Wd#r4cB|jtjy)z$,LL$rs r5r8zWebDriver.capabilitiessyyr4c@t|jjdstjdt d|j } t|d5}|j|ddd~y#1swY xYw#t$rY~ywxYw#~wxYw) aSave 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. Args: filename: 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` extensionrr wbNFT) rTrendswithr r  UserWarningget_screenshot_as_pngopenwriteOSError)rfilenamepngfs r5get_screenshot_as_filez WebDriver.get_screenshot_as_files8}""$--f5 MMp  ((* h%         s< B "A>4B >BB BBBBBc$|j|S)aSave 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. Args: filename: 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 r5save_screenshotzWebDriver.save_screenshots**844r4cRt|jjdS)zGets the screenshot of the current window as a binary data. Example: `driver.get_screenshot_as_png()` ascii)rget_screenshot_as_base64encoders r5rzWebDriver.get_screenshot_as_pngs# 668??HIIr4cF|jtjdS)zGet a base64-encoded screenshot of the current window. This encoding is useful for embedding screenshots in HTML. Example: `driver.get_screenshot_as_base64()` r)rr# SCREENSHOTrs r5rz"WebDriver.get_screenshot_as_base64s||G../88r4cp|j||jt|t|y)aYSets the width and height of the current window. Args: width: The width in pixels to set the window to. height: The height in pixels to set the window to. windowHandle: The handle of the window to resize. Default is "current". Example: `driver.set_window_size(800, 600)` widthheightN"_check_if_window_handle_is_currentset_window_rectrn)rrr windowHandles r5set_window_sizezWebDriver.set_window_sizes- // = 3u:c&kBr4c|j||j}|jddr|d}dDcic]}||| c}Scc}w)zrGets the width and height of the current window. Example: `driver.get_window_size()` rNr)rget_window_rectrU)rrsizer@s r5get_window_sizezWebDriver.get_window_sizesS // =##% 88GT "=D$78q47 888s A cn|j||jt|t|S)aiSets the x,y position of the current window. Args: x: The x-coordinate in pixels to set the window position. y: The y-coordinate in pixels to set the window position. windowHandle: The handle of the window to reposition. Default is "current". Example: `driver.set_window_position(0, 0)` xyr)rrrrs r5set_window_positionzWebDriver.set_window_positions0 // =##c!fA#77r4cv|j||j}dDcic]}||| c}Scc}w)zrGets the x,y position of the current window. Example: `driver.get_window_position()` r)rr)rrpositionr@s r5get_window_positionzWebDriver.get_window_positions< // ='')(2318A;333s 6c>|dk7rtjddyy)z5Warns if the window handle is not equal to `current`.currentz?Only 'current' window is supported for W3C compatible browsers.rr N)r r )rrs r5rz,WebDriver._check_if_window_handle_is_currents! 9 $ MMQ  %r4cF|jtjdS)zGet the window's position and size. Returns: x, y coordinates and height and width of the current window. Example: `driver.get_window_rect()` r)rr#GET_WINDOW_RECTrs r5rzWebDriver.get_window_rect$s||G334W==r4cx|||s |s td|jtj||||ddS)aSet the window's position and size. Sets the x, y coordinates and 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 r5rzWebDriver.set_window_rect/sD I!)fU*+TU U||G3311u`f5ghipqqr4c|jSr)_file_detectorrs r5rzWebDriver.file_detector@s"""r4cb|s tdt|ts td||_y)a Set the file detector for keyboard input. By default, this is set to a file detector that does nothing. See FileDetector, LocalFileDetector, and UselessFileDetector. Args: detector: 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)rrSr&r)rdetectors r5rzWebDriver.file_detectorDs1$%ST T(L1$%RS S&r4cF|jtjdS)zuGets the current orientation of the device. Example: `orientation = driver.orientation` r)rr#GET_SCREEN_ORIENTATIONrs r5 orientationzWebDriver.orientationTs||G::;GDDr4cddg}|j|vr#|jtjd|iyt d)zSets the current orientation of the device. Args: value: 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 r5rzWebDriver.orientation]sA&z2 ;;=N * LL77-9O P$%ef fr4ct|jjdrX|jjd}|jjd}| td|j dd}n|j \}}|s tdt tdt j||_|jr|j|jfS|jdjd k(r td t|jts td t||jj j"|jj j$|_ |jj'|jj(j+}|D])}|j,|j.k(s|j,}n|jj'|jj(j1d }||j_|j|jfS) Nse:cdp se:cdpVersionz%CDP version not found in capabilitiesrr2Unable to find url to connect to from capabilitieszCDP module not loadedrFrMzJCDP support for Firefox has been removed. Please switch to WebDriver BiDi.zDcommand_executor must be a RemoteConnection instance for CDP supportT)r6r>rUrr_get_cdp_detailsr2import_devtoolsrrr RuntimeErrorrSr[r*r/rEwebsocket_timeoutwebsocket_intervalrtarget get_targets target_idr1attach_to_targetr)rws_url cdp_versionversiontargetsrrsessions r5start_devtoolszWebDriver.start_devtoolsms 99== "YY]]8,F))--8K"()PQQ!'',Q/G"335OGV$%YZ Z ;$%<= =,,W5  % %>>4#=#== = 99] # ) ) +y 8kl l$//1AB$%kl l%8   ! ! / / A A  ! ! / / B B& " ,,44T^^5J5J5V5V5XY F4#=#==",,  ,,44T^^5J5J5[5[\egk5lm07""-~~t9999r4cKt|jjdrI|jjd}|jjdjdd}n|j \}}|s t dt j|}d}t|jtr |jjj}t j||4d{}|j|jj!d{}|D])}|j"|j$k(s|j"}n|j'4d{} t)| t |dddd{dddd{y777=7#1d{7swY+xYw7"#1d{7swYyxYww)Nrrrrr)max_message_size)r6r>rUrrrr2rrSr[r*rEwebsocket_max_message_sizeopen_cdprrrrr1 open_sessionr!) rrrdevtoolsrconnrrrrs r5bidi_connectionzWebDriver.bidi_connections  99== "YY]]8,FiimmO4::3?BG"335OGV$%YZ Z&&w/ d++-= >#44BB]] <<9I<J = =d LL)D)D)FGGG! ##t'A'AA & 0 0I ((3 = =w$Wc8<< = =  = = =G  = = = = =  = = = =sC;G$=F0>G$-G.F2/"G$G6F47G:F8 GF6G G$*G +G$2G4G6G8G >G?G G G$G!G G!G$c|js|j|jst|j||_|jSr)rrrrrs r5rzWebDriver.scripts<))    ||!$"<"rUrrSr[r*r/rErrr)rrs r5rzWebDriver._start_bidis 99== (YY]]>2F$%YZ Z$//1AB$%lm m%8   ! ! / / A A  ! ! / / B B& "r4c|js|j|jJt|dr |j(|jJt |j|_|jS)Nr)rrrZrrrs r5networkzWebDriver.networksj))    ))555tZ(DMM,A--9 99#D$>$>?DM}}r4c|js|j|jt|j|_|jS)aReturns a browser module object for BiDi browser commands. Returns: 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 r5browserzWebDriver.browsers?))     == #D$>$>?DM}}r4c|js|j|jt|j|_|jS)zBReturns the BiDi session object for the current WebDriver session.)rrrrrs r5_sessionzWebDriver._sessionsD))        %!()C)C!DD !!!r4c|js|j|jt|j|_|jS)aReturns a browsing context module object for BiDi browsing context commands. Returns: 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 r5browsing_contextzWebDriver.browsing_contextsD))      ! ! )%4T5O5O%PD "%%%r4c|js|j|jJ|jt|j|_|jS)aUReturns a storage module object for BiDi storage commands. Returns: An object containing access to BiDi storage commands. Examples: ``` cookie_filter = CookieFilter(name="example") result = driver.storage.get_cookies(filter=cookie_filter) cookie=PartialCookie("name", BytesValue(BytesValue.TYPE_STRING, "value") driver.storage.set_cookie(cookie=cookie, "domain")) cookie_filter=CookieFilter(name="example") driver.storage.delete_cookies(filter=cookie_filter) ``` )rrrrrs r5storagezWebDriver.storagesQ"))    ))555 == #D$>$>?DM}}r4c|js|j|jt|j|_|jS)aGet a permissions module object for BiDi permissions commands. Returns: An object containing access to BiDi permissions commands. Examples: ``` from selenium.webdriver.common.bidi.permissions import PermissionDescriptor, PermissionState descriptor = PermissionDescriptor("geolocation") driver.permissions.set_permission(descriptor, PermissionState.GRANTED, "https://example.com") ``` )rrrrrs r5 permissionszWebDriver.permissions"sD))        $ +D,F,F GD    r4c|js|j|jt|j|_|jS)ayGet a webextension module object for BiDi webextension commands. Returns: 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 r5 webextensionzWebDriver.webextension9sD))        %!-d.H.H!ID !!!r4c|js|j|jJ|jt|j|_|jS)aGet an emulation module object for BiDi emulation commands. Returns: An object containing access to BiDi emulation commands. Examples: ``` from selenium.webdriver.common.bidi.emulation import GeolocationCoordinates coordinates = GeolocationCoordinates(37.7749, -122.4194) driver.emulation.set_geolocation_override(coordinates=coordinates, contexts=[context_id]) ``` )rrrrrs r5 emulationzWebDriver.emulationMsQ))    ))555 ?? "'(B(BCDOr4c|js|j|jt|j|_|jS)a7Get an input module object for BiDi input commands. Returns: An object containing access to BiDi input commands. Examples: ``` from selenium.webdriver.common.bidi.input import KeySourceActions, KeyDownAction, KeyUpAction actions = KeySourceActions(id="keyboard", actions=[KeyDownAction(value="a"), KeyUpAction(value="a")]) driver.input.perform_actions(driver.current_window_handle, [actions]) driver.input.release_actions(driver.current_window_handle) ``` )rrrrrs r5inputzWebDriver.inputes? ))     ;;  : :;DK{{r4cX|jddlm}|||_|jS)aiReturns an APIRequestContext for making HTTP requests with browser cookie sync. Returns: An APIRequestContext instance bound to this driver. Examples: ``` response = driver.request.get("https://api.example.com/data") assert response.ok data = response.json() ``` rrt)r-selenium.webdriver.common.api_request_contextru)rrus r5requestzWebDriver.request}s' == W-d3DM}}r4c|ddl}ddl}|j} |jj ddk(r+|jj dj d}nG|jj ddvr*|jj dj d}|jd d d }|j|j}|j d }|j d }ddl } | jd|jd} | |fS#t $r t dwxYw)NrrFrGzgoog:chromeOptionsdebuggerAddressrIzms:edgeOptionszCan't get debugger address.rzhttp://z /json/versionrwebSocketDebuggerUrlz .*/(\d+)\.ra) jsonurllib3 PoolManagerr>rUAttributeErrorrr loadsdataresearchgroup) rr rhttpdebugger_addressresrbrowser_version websocket_urlrrs r5rzWebDriver._get_cdp_detailss""$ Dyy}}]+x7#'99==1E#F#J#JK\#] }-1NN#'99==1A#B#F#FGX#Y ll5G,<+=]"KLzz#((#((9-!78 ))M?;AA!D %% D$%BC C Ds BD&&D;cp|jtj|jd|_y)avAdds 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_AUTHENTICATORr?r)rrhs r5add_virtual_authenticatorz#WebDriver.add_virtual_authenticators-"&g.O.OQXQ`Q`Qb!cdk!lr4c|jS)z,Returns the id of the virtual authenticator.)rrs r5rz"WebDriver.virtual_authenticator_ids%%%r4cj|jtjd|jid|_y)zRemoves a previously added virtual authenticator. The authenticator is no longer valid after removal, so no methods may be called. authenticatorIdN)rr#REMOVE_VIRTUAL_AUTHENTICATORrrs r5remove_virtual_authenticatorz&WebDriver.remove_virtual_authenticators1  0 0  6 6 7 "&r4c|jtji|jd|jiy)a/Injects a credential into the authenticator. Example: ``` from selenium.webdriver.common.credential import Credential credential = Credential(id="user@example.com", password="aPassword") driver.add_credential(credential) ``` r N)rr#ADD_CREDENTIALr?r)r credentials r5add_credentialzWebDriver.add_credentials8  " " Oz!!# O%68N8N O r4cddlm}|jtjd|j i}|dDcgc]}|j |c}Scc}w)z;Returns the list of credentials owned by the authenticator.r)r{r r)/selenium.webdriver.common.virtual_authenticatorr{rr#GET_CREDENTIALSr from_dict)rr{credential_datar%s r5get_credentialszWebDriver.get_credentialssS O,,w'>'>ARTXTjTj@klCRSZC[\Z$ $$Z0\\\sAct|trt|j}|j t j ||jdy)zRemoves a credential from the authenticator. Example: `credential_id = "user@example.com"` `driver.remove_credential(credential_id)` ) credentialIdr N)rS bytearrayrrrr#REMOVE_CREDENTIALr)r credential_ids r5remove_credentialzWebDriver.remove_credentialsD mY /-m<CCEM  % %*t?U?U V r4c\|jtjd|jiy)z/Removes all credentials from the authenticator.r N)rr#REMOVE_ALL_CREDENTIALSrrs r5remove_all_credentialsz WebDriver.remove_all_credentialss$ W336GI_I_5`ar4c^|jtj|j|dy)aSet whether the authenticator will simulate success or failure on user verification. Args: verified: True if the authenticator will pass user verification, False otherwise. Example: `driver.set_user_verified(True)` )r isUserVerifiedN)rr#SET_USER_VERIFIEDr)rverifieds r5set_user_verifiedzWebDriver.set_user_verifieds'  % % $ 6 6( S r4c~d|jvr td|jtjddS)z9Retrieves the downloadable files as a list of file names.se:downloadsEnabledCYou must enable downloads in order to work with downloadable files.rnames)r8rrr#GET_DOWNLOADABLE_FILESrs r5get_downloadable_filesz WebDriver.get_downloadable_files s; (9(9 9$%jk k||G::;GDWMMr4cd|jvr tdtjj |stj ||j tjd|idd}tj5}tjj||dz}t|d5}|jtj|dddt!j"|d 5}|j%|ddddddy#1swYBxYw#1swYxYw#1swYyxYw) aEDownload a file with the specified file name to the target directory. Args: file_name: The name of the file to download. target_directory: The path to the directory to save the downloaded file. Example: `driver.download_file("example.zip", "/path/to/directory")` r<r=rrcontentsz.ziprNr)r8rospathexistsmakedirsrr# DOWNLOAD_FILEtempfileTemporaryDirectoryrrrbase64rzipfileZipFile extractall)r file_nametarget_directoryrBtmp_dirzip_filefilezip_refs r5 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)zDeletes all downloadable files.r<r=N)r8rrr#DELETE_DOWNLOADABLE_FILESrs r5delete_downloadable_filesz#WebDriver.delete_downloadable_files+s. (9(9 9$%jk k W667r4c^d|i}|r||d<|jtj|dS)a.Fire a custom session event to the remote server event bus. This allows test code to trigger server-side utilities that subscribe to the event bus. Args: event_type: The type of event (e.g., "test:failed", "log:collect", "marker:add"). payload: Optional data to include with the event. Returns: A dictionary containing the response data including success status, event type, and timestamp. Raises: WebDriverException: If the event cannot be fired. Examples: Simple event:: driver.fire_session_event("test:started") Event with payload:: driver.fire_session_event("test:failed", {"testName": "LoginTest", "error": "Element not found"}) eventTypepayloadr)rr#FIRE_SESSION_EVENT)r event_typer[rs r5fire_session_eventzWebDriver.fire_session_event2s74*5j(A  'F9 ||G66?HHr4c|jS)alGet the Federated Credential Management (FedCM) dialog commands. Returns: An object providing access to all Federated Credential Management (FedCM) dialog commands. Examples: `driver.fedcm.title` `driver.fedcm.subtitle` `driver.fedcm.dialog_type` `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 r5fedcmzWebDriver.fedcmQs({{r4cV|jjtjdS)z8Returns whether the browser supports FedCM capabilities.F)r8rUrFEDCM_CAPABILITYrs r5supports_fedcmzWebDriver.supports_fedcmgs#  $$Z%@%@%HHr4c2|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)rcrrs r5_require_fedcm_supportz WebDriver._require_fedcm_supportls#""$B #r4c>ddlm}|j||S)z0Returns the FedCM dialog object for interaction.rrv)&selenium.webdriver.common.fedcm.dialogrwre)rrws r5dialogzWebDriver.dialogts B ##%d|r4cddlmddlmddlm}j |f}dfd ||||}|jfdS) aWaits for and returns the FedCM dialog. Args: timeout: How long to wait for the dialog. poll_frequency: How frequently to poll. ignored_exceptions: 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)NoAlertPresentExceptionrv) WebDriverWaitcL }|jr|SdS#$rYywxYwr)r)rhrwrjrs r5 _check_fedcmz,WebDriver.fedcm_dialog.._check_fedcms4 !'v6$6*  s##)poll_frequencyignored_exceptionscSrr3)rrms r5z(WebDriver.fedcm_dialog..s LNr4)returnz Dialog | None)selenium.common.exceptionsrjrgrwselenium.webdriver.support.waitrkreuntil) rtimeoutrnrorkwaitrwrjrms ` @@@r5 fedcm_dialogzWebDriver.fedcm_dialog|sY GAA ##%  %"9!;    )1   zz233r4)zhttp://127.0.0.1:4444TNNNNN)r[str | RemoteConnectionrQboolrzFileDetector | Nonerhz&BaseOptions | list[BaseOptions] | NonerzLocatorConverter | Nonerztype[WebElement] | NonerEClientConfig | Nonerrrd)rrrT)rrr)rztype[BaseException] | NonerzBaseException | Nonerztypes.TracebackType | None)rrr)rrrd)r8rrrrd)rrTrrr.)rrTrrr)rz)str | Generator[dict[str, Any], Any, Any]rzdict[str, Any] | Nonerrr )rrTrrrd)rrTrrr+)rr+rrrd)rrz list[str])rrTrrr )rAzPrintOptions | NonerrrT)rrr-)rrz list[dict])rr dict | None)rqrorrrd)rrrz)rstr | RelativeByr str | Nonerrr.)rr~rrrrzlist[WebElement]rrr)rrrz)rrr)r)rrTrrrd)rrTrrr)rrorrorrTrrr)NNNN)rrr&)rrztuple[Any, WebSocketConnection])rrr)rrr)rrr)rrr)rrr)rrr)rrr)rrr)rrr)rrr)rrru)rhr|rrrd)rrr)r%r{rrrd)rrzlist[Credential])r1zstr | bytearrayrrrd)r9rzrrrd)rrr)rOrTrPrTrrrd)r]rTr[r}rrr)rrr%)rrrw)g?N)lrrrrr.rr,rrrrrr rpropertyrrrrrrrrrrrUrrrrrr r#r'r*rr1r4r7r:r=rBrDrGrKrNrQrYr\r_rhrrrtrxr~setterrIDrrr8rrrrrrrrrrrrrrrrrrrrrrrrrrrr rrrrr"r&r,r2r5r:r@rUrXr^r`rcrerhrxr3r4r5rrs, " O4K-1:>5937-1J*0J*J*+ J* 8 J* 3 J*1J*+J* J*X`,". 33<LL    7 \.)-*KA*K&*K *KX 0 @ @#$k&) Z2Z&>>>>$"LLEE$ 0. B&&)&>( <1F* Z X($$(__ M M35%%TZ44655da>: 5J9 C 9 8 4 >r"## ' 'EE g g%:N==2    (""&&(2!!,""&..&&6 m&&% &% &% % %]%]% % %b%b%  %  N548I>*II%4r4rr|rr) r8rr[ryrQrzr\rzrEr{rrr*)rhzlist[BaseOptions]rrr)pr __future__rrKrUr;rrrDrrItypesr rLabcrrrcollections.abcrrr importlibr typingr r r typing_extensionsrrsrrrrr&selenium.webdriver.common.bidi.browserr/selenium.webdriver.common.bidi.browsing_contextr(selenium.webdriver.common.bidi.emulationr$selenium.webdriver.common.bidi.inputr&selenium.webdriver.common.bidi.networkr*selenium.webdriver.common.bidi.permissionsr%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.remote.bidi_connectionr!'selenium.webdriver.remote.client_configr"!selenium.webdriver.remote.commandr#&selenium.webdriver.remote.errorhandlerr$selenium.webdriver.remote.fedcmr%'selenium.webdriver.remote.file_detectorr&r'+selenium.webdriver.remote.locator_converterr( selenium.webdriver.remote.mobiler)+selenium.webdriver.remote.remote_connectionr*$selenium.webdriver.remote.script_keyr+$selenium.webdriver.remote.shadowrootr,#selenium.webdriver.remote.switch_tor-$selenium.webdriver.remote.webelementr..selenium.webdriver.remote.websocket_connectionr/+selenium.webdriver.support.relative_locatorr0r2r6rBr_rsrrurgrw,selenium.webdriver.common.print_page_optionsrxr|rzr(r{r|rrrrr3r4r5rs5$$"    /%:#++";K>6:B8::D+ED@5?1SH3H:;8;NB B O0*. ++,++ + ' +  +\DO=I;ggB4 B4r4