o US`c@sdZddlZddlZddlZddlZddlZddlZddlmZddl m Z m Z ddlm Z m Z ddlmZddlmZmZmZmZddlmZmZmZmZmZdd lmZdd lmZdd lmZdd l m!Z!dd l"m#Z#ddl$m%Z%m&Z&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1m2Z2ddl3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:ddl;mZ>e?gdZ@ddddZAdaBd d!ZCd"d#ZDd0d%d&ZEd'eed(efd)d*ZFGd+d,d,ed-ZGGd.d/d/eGZHdS)1zThe WebDriver implementation.N)ABCMeta) b64decodeurlsafe_b64encode)asynccontextmanagercontextmanager) import_module)DictListOptionalUnion)InvalidArgumentExceptionJavascriptExceptionWebDriverExceptionNoSuchCookieExceptionNoSuchElementException)ByApplicationCache) BaseOptions) PrintOptions)Timeouts) CredentialVirtualAuthenticatorOptionsrequired_virtual_authenticator) RelativeBy)BidiConnection)Command) ErrorHandler) FileDetectorLocalFileDetector)Mobile)RemoteConnection) ScriptKey) ShadowRoot)SwitchTo) WebElement) acceptInsecureCerts browserNamebrowserVersionZpageLoadStrategy platformNameproxyZ setWindowRectZstrictFileInteractabilitytimeoutsZunhandledPromptBehaviorZ webSocketUrlr'r)r*)ZacceptSslCertsversionplatformcCststdadSdS)Nz"selenium.webdriver.common.bidi.cdp)cdprr0r0N/usr/local/lib/python3.10/dist-packages/selenium/webdriver/remote/webdriver.py import_cdpQs r2cCst|}|d}i}|dr$|ddr$|dd|dd<|D]4\}}|rP|tvrPt|}tj|d|dtdd|dkrL|n|||<|t vsXd |vr\|||<q(|rv|d i}d |vrvt|}||d <||d <ig|d S) 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. :Args: - caps - A dictionary of capabilities requested by the caller. firefox_profiler+Z proxyTypez is not a w3c capability. use `z5` instead. This will no longer be converted in 4.7.0 stacklevelr.:moz:firefoxOptionsprofile) firstMatch alwaysMatch) copydeepcopygetloweritems_OSS_W3C_CONVERSIONwarningswarnDeprecationWarning_W3C_CAPABILITY_NAMES)capsr9Z always_matchkvZw3c_equivalentZmoz_optsZnew_optsr0r0r1_make_w3c_capsWs,     rIFc sVddlm}ddlm}ddlm}t|||g}tfdd|Dt}||||dS)Nr)ChromiumRemoteConnection)SafariRemoteConnection)FirefoxRemoteConnectionc3s$|] }|jdkr|VqdS)r(N)Z browser_namer>).0c capabilitiesr0r1 s"z(get_remote_connection..) keep_aliveZ ignore_proxy)Z-selenium.webdriver.chromium.remote_connectionrJZ+selenium.webdriver.safari.remote_connectionrKZ,selenium.webdriver.firefox.remote_connectionrLr"next) rPcommand_executorrRignore_local_proxyrJrKrL candidateshandlerr0rOr1get_remote_connection|s    rXoptionsreturnc Csdii}g}|D] }||qt|}i}t|D]8}|}|d|krT||}|D]%} | ||dvrS||| ||d| krS|| ||| iq.qi} |D]\} } | | | <q[|D] }| D]} || =qjqf| |dd<||dd<|S)NrPrr;r:)appendto_capabilitieslenrangekeysupdater@) rYrPoptsoptZ opts_sizeZsamesiesi min_indexZ first_keysZkysalwaysrGrHr0r0r1create_matchess2      rfc@seZdZdZdS) BaseWebDriverz Abstract 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__r0r0r0r1rgsrg) metaclassc@seZdZdZeZeZ   ddee e e ffddZ dd Z d d Z d ejejed ejedejejfddZeddZedefddZedefddZddZddZddeddfddZdd Z d!edefd"d#Z!d$d%Z"dd&ed'edefd(d)Z#d*eddfd+d,Z$edefd-d.Z%dd/ede&fd0d1Z'd2e&ddfd3d4Z(de efd5d6Z)d7d8Z*d/efd9d:Z+edefd;d<Z,edefd=d>Z-dd?d@Z.ddAdBZ/edefdCdDZ0ede efdEdFZ1ddGdHZ2ddIdJZ3ddKdLZ4ddMee5defdNdOZ6ede7fdPdQZ8ddRdSZ9ddTdUZ:ddVdWZ;de efdXdYZdd\d]Z?dd^d_Z@dd`daZAdbeBddfdcddZCdbeBddfdedfZDdbeBddfdgdhZEedeFfdidjZGeGjHddkdjZGeIjJdfdleedefdmdnZKeIjJdfdleede efdodpZLedefdqdrZMedefdsdtZNdeOfdudvZPdeOfdwdxZQdeRfdydzZSdefd{d|ZTdd~eddfddZUdd~edefddZVdd~edefddZWddefddZXdefddZYddefddZZede[fddZ\e\jHdddZ\eddZ]e]jHdddZ]eddZ^eddZ_ddZ`eaddZbddZcdedddfddZeedefddZfegdddZhegdeiddfddZjegde eifddZkegdeeelfddfddZmegdddZnegdeOddfddZodS) WebDrivera Controls a browser by sending commands to a remote server. This server is expected to be running the WebDriver wire protocol as defined at https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol :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://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities - command_executor - remote_connection.RemoteConnection object used to execute commands. - error_handler - errorhandler.ErrorHandler object used to handle errors. http://127.0.0.1:4444NTrYc Cs$|r tjdtdd|rtjdtdd|rtjdtdd|s(tjdtddi}t|tr4t|}nd} |r?|}|j} |rOt|tsJt d| |||_ t|j t t frct|||| d |_ d |_d |_i|_i|_t|_t||_t||_|pt|_d |_||||d S) aX Create a new driver that will issue commands using the wire protocol. :Args: - command_executor - Either a string representing URL of the remote server or a custom remote_connection.RemoteConnection object. Defaults to 'http://127.0.0.1:4444/wd/hub'. - desired_capabilities - A dictionary of capabilities to request when starting the browser session. Required parameter. - browser_profile - A selenium.webdriver.firefox.firefox_profile.FirefoxProfile object. Only used if Firefox is requested. Optional. - proxy - A selenium.webdriver.common.proxy.Proxy object. The browser session will be started with given proxy settings, if possible. Optional. - keep_alive - Whether to configure remote_connection.RemoteConnection to use HTTP keep-alive. Defaults to True. - file_detector - Pass custom file detector object during instantiation. If None, then default LocalFileDetector() will be used. - options - instance of a driver options.Options class z]desired_capabilities has been deprecated, please pass in an Options object with options kwargr4r5z`browser_profile has been deprecated, please pass in an Firefox Options object with options kwargzNproxy has been deprecated, please pass in an Options object with options kwargzckeep_alive has been deprecated. We will be using True as the default value as we start removing it.Fz)Desired Capabilities must be a dictionary)rTrRrUTN)rBrCrD isinstancelistrfr\_ignore_local_proxydictrr`rTstrbytesrXZ _is_remote session_idrFpinned_scriptsr error_handlerr% _switch_tor!_mobiler file_detector_authenticator_id start_client start_session) selfrTdesired_capabilitiesbrowser_profiler+rRrzrYrPrqr0r0r1__init__sh       zWebDriver.__init__cCsdt||jS)Nz-<{0.__module__}.{0.__name__} (session="{1}")>)formattyperur~r0r0r1__repr__s zWebDriver.__repr__cCs|SNr0rr0r0r1 __enter__szWebDriver.__enter__exc_typeexc tracebackcCs |dSr)quit)r~rrrr0r0r1__exit__s zWebDriver.__exit__cosPd}t|j|s|j}||i||_z dVW|r ||_dSdS|r'||_w)a Overrides the current file detector (if necessary) in limited context. Ensures the original file detector is set afterwards. Example: with webdriver.file_detector_context(UselessFileDetector): someinput.send_keys('/etc/hosts') :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. N)rorz)r~Zfile_detector_classargskwargsZ last_detectorr0r0r1file_detector_contexts  zWebDriver.file_detector_contextrZcC|jSr)ryrr0r0r1mobile<zWebDriver.mobilecCsd|jvr |jdStd)zReturns the name of the underlying browser for this instance. :Usage: :: name = driver.name r(z1browserName not specified in session capabilities)rFKeyErrorrr0r0r1name@s zWebDriver.namecCdS)z Called before starting a new session. This method may be overridden to define custom startup behavior. Nr0rr0r0r1r|MzWebDriver.start_clientcCr)z Called after executing a quit command. This method may be overridden to define custom shutdown behavior. Nr0rr0r0r1 stop_clientTrzWebDriver.stop_clientrPcCst|ts td|rd|vr|j|dd<n|d|jit|}d|i}|tj|}d|vr6|d}|d|_ | d|_ |j sL| d|_ dSdS) a# Creates a new session with the desired capabilities. :Args: - capabilities - a capabilities dict to start the session with. - browser_profile - A selenium.webdriver.firefox.firefox_profile.FirefoxProfile object. Only used if Firefox is requested. z!Capabilities must be a dictionaryr8r9r3rP sessionIdvalueN) rorrr encodedr`rIexecuterZ NEW_SESSIONrur>rF)r~rPrZw3c_caps parametersresponser0r0r1r}[s   zWebDriver.start_sessioncst|tri}|D] \}}|||<q |St|jr$d|jiSt|jr/d|jiSt|tr?tfdd|DS|S)N#element-6066-11e4-a52e-4f735466cecf"shadow-6066-11e4-a52e-4f735466cecfc3|]}|VqdSr) _wrap_valuerMitemrr0r1rQz(WebDriver._wrap_value..)rorrr@r_web_element_clsid_shadowroot_clsrp)r~rZ convertedkeyvalr0rr1rws      zWebDriver._wrap_value element_idcCs |||S)z6Creates a web element with the specified `element_id`.)r)r~rr0r0r1create_web_elements zWebDriver.create_web_elementcst|tr.d|vr|dSd|vr|dS|D] \}}|||<q |St|tr>tfdd|DS|S)Nrrc3rr) _unwrap_valuerrr0r1rQrz*WebDriver._unwrap_value..)rorrrrr@rrp)r~rrrr0rr1rs  zWebDriver._unwrap_valuedriver_commandparamscCsx|jr|s d|ji}n d|vr|j|d<||}|j||}|r5|j|||dd|d<|Sdd|jdS)aQ Sends a command to be executed by a command.CommandExecutor. :Args: - driver_command: The name of the command to execute as a string. - params: A dictionary of named parameters to send with the command. :Returns: The command's JSON response loaded into a dictionary object. rrNr)successrr)rurrTrrwZcheck_responserr>)r~rrrr0r0r1rs      zWebDriver.executeurlcC|tjd|idS)zB Loads a web page in the current browser session. rN)rrGET)r~rr0r0r1r>sz WebDriver.getcCs|tjddS)zuReturns the title of the current page. :Usage: :: title = driver.title r)rrZ GET_TITLEr>rr0r0r1titles zWebDriver.titlescriptcCst|}||j|j<|S)zMStore common javascript scripts to be executed later by a unique hashable ID.)r#rvr)r~r script_keyZscript_key_instancer0r0r1 pin_scripts zWebDriver.pin_scriptrcCs<z |j|jWdStytd|d|jdw)z$Remove a pinned script from storage.zNo script with key: z existed in N)rvpoprr)r~rr0r0r1unpins  zWebDriver.unpincCs t|jSr)rprvrr0r0r1get_pinned_scriptss zWebDriver.get_pinned_scriptscGsVt|trz|j|j}Wn tytdwt|}tj}| |||ddS)a0 Synchronously Executes JavaScript in the current window/frame. :Args: - script: The JavaScript to execute. - \*args: Any applicable arguments for your JavaScript. :Usage: :: driver.execute_script('return document.title;') z Pinned script could not be foundrrr) ror#rvrrr rprZW3C_EXECUTE_SCRIPTrr~rrZconverted_argscommandr0r0r1execute_scripts  zWebDriver.execute_scriptcGs$t|}tj}||||ddS)a Asynchronously Executes JavaScript in the current window/frame. :Args: - script: The JavaScript to execute. - \*args: Any applicable arguments for your JavaScript. :Usage: :: script = "var callback = arguments[arguments.length - 1]; " \ "window.setTimeout(function(){ callback('timeout') }, 3000);" driver.execute_async_script(script) rr)rprZW3C_EXECUTE_SCRIPT_ASYNCrrr0r0r1execute_async_scriptszWebDriver.execute_async_scriptcC|tjdS)zw Gets the URL of the current page. :Usage: :: driver.current_url r)rrZGET_CURRENT_URLrr0r0r1 current_url zWebDriver.current_urlcCr)zz Gets the source of the current page. :Usage: :: driver.page_source r)rrZGET_PAGE_SOURCErr0r0r1 page_sourcerzWebDriver.page_sourcecC|tjdS)zl Closes the current window. :Usage: :: driver.close() N)rrZCLOSErr0r0r1close zWebDriver.closecCs:z|tjW||jdS||jw)z Quits the driver and closes every associated window. :Usage: :: driver.quit() N)rrZQUITrrTrrr0r0r1r)s   zWebDriver.quitcCr)z Returns the handle of the current window. :Usage: :: driver.current_window_handle r)rrZW3C_GET_CURRENT_WINDOW_HANDLErr0r0r1current_window_handle8rzWebDriver.current_window_handlecCr)z Returns the handles of all windows within the current session. :Usage: :: driver.window_handles r)rrZW3C_GET_WINDOW_HANDLESrr0r0r1window_handlesDrzWebDriver.window_handlescCstj}||ddS)zF Maximizes the current window that webdriver is using N)rZW3C_MAXIMIZE_WINDOWr)r~rr0r0r1maximize_windowPszWebDriver.maximize_windowcCr)zM Invokes the window manager-specific 'full screen' operation N)rrZFULLSCREEN_WINDOWrr0r0r1fullscreen_windowWzWebDriver.fullscreen_windowcCr)zJ Invokes the window manager-specific 'minimize' operation N)rrZMINIMIZE_WINDOWrr0r0r1minimize_window]rzWebDriver.minimize_window print_optionscCs"i}|r|}|tj|dS)z Takes PDF of the current page. The driver makes a best effort to return a PDF based on the provided parameters. r)to_dictrrZ PRINT_PAGE)r~rrYr0r0r1 print_pagecszWebDriver.print_pagecCr)a< :Returns: - SwitchTo: an object containing all options to switch focus into :Usage: :: 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') )rxrr0r0r1 switch_tonszWebDriver.switch_tocCr)z Goes one step backward in the browser history. :Usage: :: driver.back() N)rrZGO_BACKrr0r0r1backrzWebDriver.backcCr)z Goes one step forward in the browser history. :Usage: :: driver.forward() N)rrZ GO_FORWARDrr0r0r1forwardrzWebDriver.forwardcCr)zo Refreshes the current page. :Usage: :: driver.refresh() N)rrZREFRESHrr0r0r1refreshrzWebDriver.refreshcCr)z Returns a set of dictionaries, corresponding to cookies visible in the current session. :Usage: :: driver.get_cookies() r)rrZGET_ALL_COOKIESrr0r0r1 get_cookiesrzWebDriver.get_cookiescCsDtt|tjd|idWdS1swYdS)z Get a single cookie by name. Returns the cookie if found, None if not. :Usage: :: driver.get_cookie('my_cookie') rrN) contextlibsuppressrrrZ GET_COOKIEr~rr0r0r1 get_cookies $zWebDriver.get_cookiecCr)z Deletes a single cookie with the given name. :Usage: :: driver.delete_cookie('my_cookie') rN)rrZ DELETE_COOKIErr0r0r1 delete_cookies zWebDriver.delete_cookiecCr)z Delete all cookies in the scope of the session. :Usage: :: driver.delete_all_cookies() N)rrZDELETE_ALL_COOKIESrr0r0r1delete_all_cookiesrzWebDriver.delete_all_cookiescCsDd|vr|ddvs J|tjd|idS|tjd|idS)aK Adds a cookie to your current session. :Args: - cookie_dict: A dictionary object, with required keys - "name" and "value"; optional keys - "path", "domain", "secure", "httpOnly", "expiry", "sameSite" Usage: 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'}) ZsameSite)ZStrictZLaxNonecookieN)rrZ ADD_COOKIE)r~ cookie_dictr0r0r1 add_cookieszWebDriver.add_cookie time_to_waitcC"|tjdtt|didS)a Sets 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. :Args: - time_to_wait: Amount of time to wait (in seconds) :Usage: :: driver.implicitly_wait(30) implicitNrr SET_TIMEOUTSintfloatr~rr0r0r1implicitly_waits zWebDriver.implicitly_waitcCr)a- Set the amount of time that the script should wait during an execute_async_script call before throwing an error. :Args: - time_to_wait: The amount of time to wait (in seconds) :Usage: :: driver.set_script_timeout(30) rrNrrr0r0r1set_script_timeouts  zWebDriver.set_script_timeoutc CsVz|tjdtt|diWdSty*|tjt|dddYdSw)a Set the amount of time to wait for a page load to complete before throwing an error. :Args: - time_to_wait: The amount of time to wait :Usage: :: driver.set_page_load_timeout(30) pageLoadrz page load)msrN)rrrrrrrr0r0r1set_page_load_timeout s   zWebDriver.set_page_load_timeoutcCsT|tjd}|dd|d<|dd|d<|dd|d<td i|S) z Get all the timeouts that have been set on the current session :Usage: :: driver.timeouts :rtype: Timeout rrrZ implicit_waitrZ page_loadrNr0)rrZ GET_TIMEOUTSrr)r~r,r0r0r1r,s  zWebDriver.timeoutscCs|tj|d}dS)a Set all timeouts for the session. This will override any previously set timeouts. :Usage: :: my_timeouts = Timeouts() my_timeouts.implicit_wait = 10 driver.timeouts = my_timeouts rN)rrrZ_to_json)r~r,_r0r0r1r,/s rcCst|tr|j||d}|std|j|dS|tjkr'tj}d|}n|tjkr4tj}d|}n |tj kr@tj}d|}| t j ||ddS) z Find an element given a By strategy and locator. :Usage: :: element = driver.find_element(By.ID, 'foo') :rtype: WebElement )byrz%Cannot locate relative element with: r [id="%s"].%s [name="%s"]usingrr) ror find_elementsrrootrID CSS_SELECTOR CLASS_NAMENAMErrZ FIND_ELEMENT)r~rrelementsr0r0r1 find_element=s(      zWebDriver.find_elementcCst|tr(dtddd}t|dd}d|d}||| S|t j kr5t j }d|}n|t j krBt j }d |}n |t jkrNt j }d |}|tj||d d p[gS) z Find elements given a By strategy and locator. :Usage: :: elements = driver.find_elements(By.CLASS_NAME, 'foo') :rtype: list of WebElement .NzfindElements.jsutf8zreturn (z).apply(null, arguments);rrrrr)rorjoinrhsplitpkgutilget_datadecoderrrrrrrrrZ FIND_ELEMENTS)r~rrZ_pkgZ raw_functionZfind_element_jsr0r0r1r\s,       zWebDriver.find_elementscCstjdtdd|jS)zM returns the drivers current desired capabilities being used z=desired_capabilities is deprecated. Please call capabilities.r4r5)rBrCrDrFrr0r0r1r}szWebDriver.desired_capabilitiescCr)zF returns the drivers current capabilities being used. )rFrr0r0r1rPzWebDriver.capabilitiescCs|ds tdt|}z1z$t|d }||Wdn 1s(wYWW~dSWW~dStyBYW~dSw~w)a Saves 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. :Usage: :: 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` extensionwbNFT) r?endswithrBrC UserWarningget_screenshot_as_pngopenwriteOSError)r~filenameZpngfr0r0r1get_screenshot_as_files&    z WebDriver.get_screenshot_as_filecCs ||S)a Saves 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. :Usage: :: driver.save_screenshot('/Screenshots/foo.png') )r)r~r r0r0r1save_screenshots zWebDriver.save_screenshotcCst|dS)z Gets the screenshot of the current window as a binary data. :Usage: :: driver.get_screenshot_as_png() ascii)rget_screenshot_as_base64encoderr0r0r1rs zWebDriver.get_screenshot_as_pngcCr)z Gets the screenshot of the current window as a base64 encoded string which is useful in embedded images in HTML. :Usage: :: driver.get_screenshot_as_base64() r)rrZ SCREENSHOTrr0r0r1rrz"WebDriver.get_screenshot_as_base64current windowHandlecCs,|dkr td|jt|t|ddS)a- Sets the width and height of the current window. (window.resizeTo) :Args: - width: the width in pixels to set the window to - height: the height in pixels to set the window to :Usage: :: driver.set_window_size(800,600) r?Only 'current' window is supported for W3C compatible browsers.widthheightNrBrCset_window_rectr)r~rrrr0r0r1set_window_sizes zWebDriver.set_window_sizecs@|dkr td|ddrdfdddDS)z Gets the width and height of the current window. :Usage: :: driver.get_window_size() rrrNci|]}||qSr0r0rMrGsizer0r1 z-WebDriver.get_window_size..r)rBrCget_window_rectr>r~rr0rr1get_window_sizes   zWebDriver.get_window_sizecCs(|dkr td|jt|t|dS)a7 Sets the x,y position of the current window. (window.moveTo) :Args: - x: the x-coordinate in pixels to set the window position - y: the y-coordinate in pixels to set the window position :Usage: :: driver.set_window_position(0,0) rrxyr)r~r&r'rr0r0r1set_window_positions zWebDriver.set_window_positioncs,|dkr td|fdddDS)z Gets the x,y position of the current window. :Usage: :: driver.get_window_position() rrcrr0r0rpositionr0r1r r!z1WebDriver.get_window_position..r%)rBrCr"r#r0r)r1get_window_positions zWebDriver.get_window_positioncCr)z Gets the x, y coordinates of the window as well as height and width of the current window. :Usage: :: driver.get_window_rect() r)rrZGET_WINDOW_RECTrr0r0r1r"rzWebDriver.get_window_rectcCs<|dur|dur|s|std|tj||||ddS)a Sets 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`. :Usage: :: 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) Nz'x and y or height and width need values)r&r'rrr)r rrZSET_WINDOW_RECT)r~r&r'rrr0r0r1r"s zWebDriver.set_window_rectcCrr)_file_detectorrr0r0r1rz8rzWebDriver.file_detectorcCs(|stdt|tstd||_dS)a9 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 :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)rrorr,)r~detectorr0r0r1rz<s    cCr)z Gets the current orientation of the device :Usage: :: orientation = driver.orientation r)rrZGET_SCREEN_ORIENTATIONrr0r0r1 orientationOrzWebDriver.orientationcCs2ddg}||vr|tjd|idStd)z Sets the current orientation of the device :Args: - value: orientation to set it to. :Usage: :: driver.orientation = 'landscape' Z LANDSCAPEZPORTRAITr.z>You can only set the orientation to 'LANDSCAPE' and 'PORTRAIT'N)upperrrZSET_SCREEN_ORIENTATIONr)r~rZallowed_valuesr0r0r1r.[s cCst|S)zI Returns a ApplicationCache Object to interact with the browser app cacherrr0r0r1application_cachenszWebDriver.application_cachecCr)z Gets a list of the available log types. This only works with w3c compliant browsers. :Usage: :: driver.log_types r)rrZGET_AVAILABLE_LOG_TYPESrr0r0r1 log_typessrzWebDriver.log_typescCs|tjd|idS)aF Gets the log for a given log type :Args: - log_type: type of log that which will be returned :Usage: :: driver.get_log('browser') driver.get_log('driver') driver.get_log('client') driver.get_log('server') rr)rrZGET_LOG)r~Zlog_typer0r0r1get_logszWebDriver.get_logc Cs t|jdr|jd}|jddd}n|\}}|s(tdt|}t|4IdHB}| |j IdH}|dj }| |4IdH}t|t|VWdIdHn 1IdHshwYWdIdHdS1IdHs~wYdS)Nzse:cdpz se:cdpVersionrrz2Unable to find url to connect to from capabilities)r2rFr>r_get_cdp_detailsrr/Zimport_devtoolsZopen_cdprtargetZ get_targets target_idZ open_sessionr)r~Zws_urlr-Zdevtoolsconntargetsr5sessionr0r0r1bidi_connections      *.zWebDriver.bidi_connectionc Csddl}ddl}|}d}|jddkr+|j|jd|jddd}nd}|jd }|d d |d }||j}|d }|d} ddl } |rYd} | | fS| d| d} | | fS)NrFr(Zchromer7OptionsZdebuggerAddressTzmoz:debuggerAddressrzhttp://z /json/versionZBrowserZwebSocketDebuggerUrlUz .*/(\d+)\.r) jsonurllib3 PoolManagerrFr>Z vendor_prefixrequestloadsdataresearchgroup) r~r<r=httpZ_firefoxZdebugger_addressresrAZbrowser_versionZ websocket_urlrBr-r0r0r1r3s("    zWebDriver._get_cdp_detailscCs|tj|d|_dS)zF Adds a virtual authenticator with the given options. rN)rrZADD_VIRTUAL_AUTHENTICATORrr{)r~rYr0r0r1add_virtual_authenticatorsz#WebDriver.add_virtual_authenticatorcCr)z> Returns the id of the virtual authenticator. )r{rr0r0r1virtual_authenticator_idrz"WebDriver.virtual_authenticator_idcCs|tjd|jid|_dS)z Removes a previously added virtual authenticator. The authenticator is no longer valid after removal, so no methods may be called. authenticatorIdN)rrZREMOVE_VIRTUAL_AUTHENTICATORr{rr0r0r1remove_virtual_authenticators z&WebDriver.remove_virtual_authenticator credentialcCs$|tji|d|jidS)z> Injects a credential into the authenticator. rIN)rrZADD_CREDENTIALrr{)r~rKr0r0r1add_credentialszWebDriver.add_credentialcCs&|tjd|ji}dd|dDS)zM Returns the list of credentials owned by the authenticator. rIcSsg|]}t|qSr0)r from_dict)rMrKr0r0r1 r!z-WebDriver.get_credentials..r)rrZGET_CREDENTIALSr{)r~Zcredential_datar0r0r1get_credentialsszWebDriver.get_credentials credential_idcCs2t|tur t|}|tj||jddS)z> Removes a credential from the authenticator. )Z credentialIdrIN)r bytearrayrrrrZREMOVE_CREDENTIALr{)r~rPr0r0r1remove_credentials   zWebDriver.remove_credentialcCs|tjd|jidS)zA Removes all credentials from the authenticator. rIN)rrZREMOVE_ALL_CREDENTIALSr{rr0r0r1remove_all_credentialssz WebDriver.remove_all_credentialsverifiedcCs|tj|j|ddS)z Sets whether the authenticator will simulate success or fail on user verification. verified: True if the authenticator will pass user verification, False otherwise. )rIZisUserVerifiedN)rrZSET_USER_VERIFIEDr{)r~rTr0r0r1set_user_verifieds zWebDriver.set_user_verified)rnNNNTNNr)rZN)r)NNNN)prhrirjrkr&rr$rr rr rrrtypingr Type BaseExceptiontypes TracebackTyperrrpropertyr!rrsrr|rrrr}rrrrr>rr#rrrrrrrrrrrrrrrrr%rrrrrrrrrrrrrrrr,setterrrrrrrPboolrrrtrrrr$r(r+r"rrrzr.r0r1r2rr9r3rrGrHrrJrrLrOrQrRrSrUr0r0r0r1rms L                 "!             rm)F)Irkrr<rrYrVrBabcrbase64rrrr importlibrrr r r Zselenium.common.exceptionsr r rrrZselenium.webdriver.common.byrZ1selenium.webdriver.common.html5.application_cacherZ!selenium.webdriver.common.optionsrZ,selenium.webdriver.common.print_page_optionsrZ"selenium.webdriver.common.timeoutsrZ/selenium.webdriver.common.virtual_authenticatorrrrZ+selenium.webdriver.support.relative_locatorrr9rrrZ errorhandlerrrzrr rr!Zremote_connectionr"rr#Z shadowrootr$rr%Z webelementr& frozensetrErAr/r2rIrXrfrgrmr0r0r0r1sT                   %"