o US`c$@spddlmZddlmZddlmZddlmZddl Z ddl m Z ddl m ZdZdZdZGdddeZdS) ) BaseOptions)Service)OptionsN)ChromiumRemoteConnection) WebDrivercseZdZdZedddedefdedeffdd Z ddZ d d Z d)d d Z d)ddZ deded dfddZdedefddZd efddZddZded efddZded efdd Zded efd!d"Zded efd#d$Zd)fd%d& Zd efd'd(ZZS)*ChromiumDriverz` Controls the WebDriver instance of ChromiumDriver and allows you to drive the browser. Noptionsservicec s|r tjdtdd|tkrtjdtdd||_|tkr%tjdtdd| tkr8t|kr8tjdtddnd} ||_d} |sE| }|rV| D] \} } | | | qK|j r\|j } |sbt d ||_|jztjt|jj||| | d |d Wn ty|wd |_dS) a Creates a new WebDriver instance of the ChromiumDriver. Starts the service and then creates new WebDriver instance of ChromiumDriver. :Args: - browser_name - Browser name used when matching capabilities. - vendor_prefix - Company prefix to apply to vendor-specific WebDriver extension commands. - port - Deprecated: port you would like the service to run, if left as 0, a free port will be found. - options - this takes an instance of ChromiumOptions - service_args - Deprecated: List of args to pass to the driver service - desired_capabilities - Deprecated: Dictionary object with non-browser specific capabilities only, such as "proxy" or "loggingPref". - service_log_path - Deprecated: Where to log information from the driver. - keep_alive - Deprecated: Whether to configure ChromiumRemoteConnection to use HTTP keep-alive. zIdesired_capabilities has been deprecated, please pass in a Service object) stacklevelz9port has been deprecated, please pass in a Service objectzEservice_log_path has been deprecated, please pass in a Service objectz?keep_alive has been deprecated, please pass in a Service objectTNzservice cannot be None)Zremote_server_addr browser_name vendor_prefix keep_aliveZ ignore_proxy)Zcommand_executorrF)warningswarnDeprecationWarning DEFAULT_PORTportDEFAULT_SERVICE_LOG_PATHDEFAULT_KEEP_ALIVEtyper create_optionsitemsZset_capabilityZ_ignore_local_proxyAttributeErrorr startsuper__init__rZ service_url ExceptionquitZ _is_remote) selfr r rrZ service_argsZdesired_capabilitiesZservice_log_pathr rZ _ignore_proxykeyvalue __class__P/usr/local/lib/python3.10/dist-packages/selenium/webdriver/chromium/webdriver.pyr%sZ   zChromiumDriver.__init__cC|dd|iS)z&Launches Chromium app specified by id.Z launchAppidexecute)rr'r$r$r% launch_appgszChromiumDriver.launch_appcC|ddS)z Gets Chromium network emulation settings. :Returns: A dict. For example: {'latency': 4, 'download_throughput': 2, 'upload_throughput': 2, 'offline': False} ZgetNetworkConditionsr!r(rr$r$r%get_network_conditionsks z%ChromiumDriver.get_network_conditionsreturncKs|dd|idS)a" Sets Chromium network emulation settings. :Args: - network_conditions: A dict with conditions specification. :Usage: :: driver.set_network_conditions( offline=False, latency=5, # additional latency (ms) download_throughput=500 * 1024, # maximal throughput upload_throughput=500 * 1024) # maximal throughput Note: 'throughput' can be used to set both (for download and upload). ZsetNetworkConditionsnetwork_conditionsNr()rr/r$r$r%set_network_conditionsvs z%ChromiumDriver.set_network_conditionscCs|ddS)z= Resets Chromium network emulation settings. ZdeleteNetworkConditionsNr(r,r$r$r%delete_network_conditionsz(ChromiumDriver.delete_network_conditionsnamer!cCs|dd|i|ddS)a Sets Applicable Permission. :Args: - name: The item to set the permission on. - value: The value to set on the item :Usage: :: driver.set_permissions('clipboard-read', 'denied') ZsetPermissionsr3)Z descriptorstateNr()rr3r!r$r$r%set_permissionss zChromiumDriver.set_permissionscmdcmd_argscCs|d||ddS)a Execute 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/ :Args: - cmd: A str, command name - cmd_args: A dict, command args. empty dict {} if there is no command args :Usage: :: driver.execute_cdp_cmd('Network.getResponseBody', {'requestId': requestId}) :Returns: A dict, empty dict {} if there is no result to return. For example to getResponseBody: {'base64Encoded': False, 'body': 'response body string'} ZexecuteCdpCommand)r6paramsr!r()rr6r7r$r$r%execute_cdp_cmdszChromiumDriver.execute_cdp_cmdcCr+)z? :Returns: A list of sinks available for Cast. ZgetSinksr!r(r,r$r$r% get_sinksr2zChromiumDriver.get_sinkscCr+)zW :Returns: An error message when there is any issue in a Cast session. ZgetIssueMessager!r(r,r$r$r%get_issue_messager2z ChromiumDriver.get_issue_message sink_namecCr&)z Sets a specific sink, using its name, as a Cast session receiver target. :Args: - sink_name: Name of the sink to use as the target. Z setSinkToUsesinkNamer(rr<r$r$r%set_sink_to_usezChromiumDriver.set_sink_to_usecCr&)z Starts a desktop mirroring session on a specific receiver target. :Args: - sink_name: Name of the sink to use as the target. ZstartDesktopMirroringr=r(r>r$r$r%start_desktop_mirroringr@z&ChromiumDriver.start_desktop_mirroringcCr&)z Starts a tab mirroring session on a specific receiver target. :Args: - sink_name: Name of the sink to use as the target. ZstartTabMirroringr=r(r>r$r$r%start_tab_mirroringr@z"ChromiumDriver.start_tab_mirroringcCr&)z Stops the existing Cast session on a specific receiver target. :Args: - sink_name: Name of the sink to stop the Cast session. Z stopCastingr=r(r>r$r$r% stop_castingr@zChromiumDriver.stop_castingcsPz!ztWn tyYn wW|jdSW|jdS|jw)z Closes the browser and shuts down the ChromiumDriver executable that is started when starting the ChromiumDriver N)rrrr stopr,r"r$r%rs zChromiumDriver.quitcCs|jdkrtStS)Nms)r EdgeOptions ChromeOptionsr,r$r$r%rszChromiumDriver.create_options)r.N)__name__ __module__ __qualname____doc__rrrrrrr*r-r0r1strr5dictr9listr:r;r?rArBrCrr __classcell__r$r$r"r%r s0B      r)Z!selenium.webdriver.common.optionsrZ!selenium.webdriver.common.servicerZselenium.webdriver.edge.optionsrrFZ!selenium.webdriver.chrome.optionsrGrZ-selenium.webdriver.chromium.remote_connectionrZ#selenium.webdriver.remote.webdriverrZRemoteWebDriverrrrrr$r$r$r%s