U
|
\ ±d#© ã @ sZ d Z ddlZddlZddlZddlZddlZddlZddlmZ ddl m
|
Z
|
ddl m Z ddlm Z ddlm Z ddlmZ dd lmZ dd
|
lmZ dd lmZ dd lmZ dd lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddl m Z ddl m Z ddl m!Z! ddl"m#Z# ddl$m%Z% ddl$m&Z& ddl$m'Z' ddl(m)Z) dd l*m+Z+ dd l,m-Z- dd l.m/Z/ dd l0m1Z1 dd l0m2Z2 dd!l3m4Z4 dd"l5m6Z6 dd#l7m8Z8 dd$l9m:Z: dd%l;m<Z< dd&l=m>Z> e?d'd(d)d*d+d,d-d.d/d0d1g Z@d'd)d+d2ZAdaBd3d4 ZCd5d6 ZDdBd8d9ZEee ed:d;d<ZFG d=d> d>ed?ZGG d@dA dAeGZHdS )Cz The WebDriver implementation.é N)ÚABCMeta)Ú b64decode)Úurlsafe_b64encode)Úasynccontextmanager)Úcontextmanager)Ú import_module)ÚDict)ÚList)ÚOptional)ÚUnion)ÚInvalidArgumentException)ÚJavascriptException)ÚNoSuchCookieException)ÚNoSuchElementException)ÚWebDriverException)ÚBy©ÚApplicationCache)Ú BaseOptions)Ú PrintOptions)ÚTimeouts)Ú
|
Credential)ÚVirtualAuthenticatorOptions)Ú required_virtual_authenticator)Ú
|
RelativeByé )ÚBidiConnection)ÚCommand)Ú ErrorHandler)Ú FileDetector)ÚLocalFileDetector)ÚMobile)ÚRemoteConnection)Ú ScriptKey)Ú
|
ShadowRoot)ÚSwitchTo)Ú
|
WebElementZacceptInsecureCertsÚ browserNameZbrowserVersionZpageLoadStrategyZ platformNameÚproxyZ setWindowRectZstrictFileInteractabilityÚtimeoutsZunhandledPromptBehaviorZ webSocketUrl)ZacceptSslCertsÚversionÚplatformc C s t s tda d S )Nz"selenium.webdriver.common.bidi.cdp)Úcdpr © r- r- úZd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\selenium/webdriver/remote/webdriver.pyÚ
|
import_cdpV s r/ c C sø t | ¡} | d¡}i }| d¡rH| d d¡rH| d d ¡ | d d< | ¡ D ]h\}}|r |tkr t| }tj| d| dtdd |dkr| ¡ n|||< |t ks°d |krP|||< qP|rì| d
|
i ¡}d |krìt |¡}||d < ||d
|
< i g|d S ) a Makes 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:firefoxOptionsÚprofile)Ú
|
firstMatchÚ alwaysMatch)
|
ÚcopyÚdeepcopyÚgetÚlowerÚitemsÚ_OSS_W3C_CONVERSIONÚwarningsÚwarnÚDeprecationWarningÚ_W3C_CAPABILITY_NAMES)Úcapsr6 Z always_matchÚkÚvZw3c_equivalentZmoz_optsZnew_optsr- r- r. Ú_make_w3c_caps\ s.
|
|
ü
|
|
rF Fc sV ddl m} ddlm} ddlm} t|||g}t fdd|D t}||||dS )Nr )ÚChromiumRemoteConnection)ÚFirefoxRemoteConnection)ÚSafariRemoteConnectionc 3 s" | ]}|j d ¡kr|V qdS )r' N)Z browser_namer; )Ú.0Úc©Ú capabilitiesr- r. Ú <genexpr> s z(get_remote_connection.<locals>.<genexpr>)Ú
|
keep_aliveZ ignore_proxy)Z-selenium.webdriver.chromium.remote_connectionrG Z,selenium.webdriver.firefox.remote_connectionrH Z+selenium.webdriver.safari.remote_connectionrI r" Únext) rM Úcommand_executorrO Úignore_local_proxyrG rH rI Ú
|
candidatesÚhandlerr- rL r. Úget_remote_connection
s rU ©ÚoptionsÚreturnc C sþ di i}g }| D ]}| | ¡ ¡ qt|}i }t|D ]p}|}|d |k r8|| ¡ }|D ]J} | ||d ¡ kr\|| | ||d | kr\| | || | i¡ q\q8i }
|
| ¡ D ]\} } | |
|
| < q¶|D ]}|
|
D ]
|
} || = qÔqÌ|
|
|d d< ||d d< |S )NrM r r8 r7 )ÚappendÚto_capabilitiesÚlenÚrangeÚkeysÚupdater= ) rW rM ÚoptsÚoptZ opts_sizeZsamesiesÚiZ min_indexZ
|
first_keysZkysÚalwaysrD rE r- r- r. Úcreate_matches s.
|
|
rc c @ s e Zd ZdZdS )Ú 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__r- r- r- r. rd ² s rd )Ú metaclassc @ s e Zd ZdZeZeZd¬ee e
|
e f ddddZ dd Z d
|
d Z ejeje eje ejej d d dZedd ZeedddZeedddZdd Z dd Z de dddd Z d d Z eed d d!Z!d"d# Z"d®ee e d$d%d&Z#edd'd(d)Z$eedd*d+Z%d¯ee&d,d-d.Z'e&dd/d0d1Z(e
|
e dd2d3Z)d4d5 Z*ed6d7d8Z+eedd9d:Z,eedd;d<Z-ddd=d>Z.ddd?d@Z/eeddAdBZ0ee
|
e ddCdDZ1dddEdFZ2dddGdHZ3dddIdJZ4d°ee5 edKdLdMZ6ee7ddNdOZ8dddPdQZ9dddRdSZ:dddTdUZ;e
|
e ddVdWZ<ejej= ddXdYZ>dddZd[Z?ddd\d]Z@ddd^d_ZAeBdd`dadbZCeBdd`dcddZDeBdd`dedfZEeeFddgdhZGeGjHdddidhZGeIjJdfee edjdkdlZKeIjJdfee e
|
e djdmdnZLee ddodpZMee ddqdrZNeOddsdtZPeOddudvZQeRddwdxZSeddydzZTd±edd|d}d~ZUd²ee d|ddZVd³ee d|ddZWd´e dddZXe dd
dZYdµe dddZZee[dddZ\e\jHddddZ\edd Z]e]jHddddZ]edd Z^edd Z_dd Z`eadd Zbdd ZcedddddZeeedddZfegddddZhegeiddd d¡Zjege
|
ei dd¢d£Zkegeeelf dd¤d¥d¦Zmegddd§d¨ZnegeOdd©dªd«ZodS )¶Ú 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:4444NTrV c
|
C s& |rt jdtdd |r(t jdtdd |r<t jdtdd |sPt jdtdd i }t|trht|}n6d} |r~| ¡ }|j} |rt|tst d|
|
|¡ || _ t| j t t frÆt|||| d | _ d
|
| _d | _i | _i | _t | _t| | _t| | _|pt | _d | _| ¡ | ||¡ d S ) aW 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 kwargr1 r2 z`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)rQ rO rR TN) r? r@ rA Ú
|
isinstanceÚlistrc rZ Ú_ignore_local_proxyÚdictr r^ rQ ÚstrÚbytesrU Z
|
_is_remoteÚ
|
session_idrC Úpinned_scriptsr Ú error_handlerr% Ú
|
_switch_tor! Ú_mobiler Ú file_detectorÚ_authenticator_idÚ start_clientÚ start_session)
|
ÚselfrQ Údesired_capabilitiesÚbrowser_profiler( rO rw rW rM rn r- r- r. Ú__init__Ê sl ýýýý
|
|
|
|
ü
|
|
zWebDriver.__init__c C s& dt | j dt | j d| j dS )Nú<Ú.z (session="z")>)Útyperf re rr ©r{ r- r- r. Ú__repr__ s zWebDriver.__repr__c C s | S ©Nr- r r- r- r. Ú __enter__# s zWebDriver.__enter__)Úexc_typeÚexcÚ tracebackc C s | ¡ d S r )Úquit)r{ r r r r- r- r. Ú__exit__& s zWebDriver.__exit__c o s> d}t | j|s"| j}|||| _z
|
dV W 5 |r8|| _X dS )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)rl rw )r{ Zfile_detector_classÚargsÚkwargsZ last_detectorr- r- r. Úfile_detector_context. s
|
z WebDriver.file_detector_context)rX c C s | j S r )rv r r- r- r. ÚmobileJ s zWebDriver.mobilec C s d| j kr| j d S tddS )zReturns the name of the underlying browser for this instance.
|
|
:Usage:
|
::
|
|
name = driver.name
|
r' z1browserName not specified in session capabilitiesN)rC ÚKeyErrorr r- r- r. ÚnameN s
|
|
zWebDriver.namec C s dS )zxCalled before starting a new session.
|
|
This method may be overridden to define custom startup behavior.
|
Nr- r r- r- r. ry [ s zWebDriver.start_clientc C s dS )zCalled after executing a quit command.
|
|
This method may be overridden to define custom shutdown
|
behavior.
|
Nr- r r- r- r. Ú stop_clientb s zWebDriver.stop_client)rM rX c C s t |tstd|r>d|kr.|j|d d< n| d|ji¡ t|}d|i}| tj|¡}d|krl|d }|d | _ |
|
d¡| _ | j s|
|
d¡| _ dS ) 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 dictionaryr5 r6 r0 rM Ú sessionIdÚvalueN) rl ro r Úencodedr^ rF Úexecuter Z NEW_SESSIONrr r; rC )r{ rM r} Zw3c_capsÚ
|
parametersÚresponser- r- r. rz j s
|
|
zWebDriver.start_sessionc s t |tr2i }| ¡ D ]\}} |¡||< q|S t | jrHd|jiS t | jr^d|jiS t |tr~t fdd|D S |S )Nú#element-6066-11e4-a52e-4f735466cecfú"shadow-6066-11e4-a52e-4f735466cecfc 3 s | ]} |¡V qd S r )Ú _wrap_value©rJ Úitemr r- r. rN s z(WebDriver._wrap_value.<locals>.<genexpr>)rl ro r= r Ú_web_element_clsÚidÚ_shadowroot_clsrm )r{ r Z convertedÚkeyÚvalr- r r. r
s
|
|
|
|
zWebDriver._wrap_value)Ú
|
element_idrX c C s | | |¡S )z6Creates a web element with the specified `element_id`.)r )r{ r¢ r- r- r. Úcreate_web_element s z WebDriver.create_web_elementc s t |tr\d|kr |d ¡S d|kr8 |d ¡S | ¡ D ]\}} |¡||< q@|S t |tr|t fdd|D S |S )Nr r c 3 s | ]} |¡V qd S r )Ú _unwrap_valuer r r- r. rN ¡ s z*WebDriver._unwrap_value.<locals>.<genexpr>)rl ro r£ r r= r¤ rm )r{ r r r¡ r- r r. r¤ s
|
|
zWebDriver._unwrap_value)Údriver_commandÚparamsrX c C sx | |¡}| jr2|s d| ji}nd|kr2| j|d< | j ||¡}|rj| j |¡ | | dd¡¡|d< |S dd| jdS )aH 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.
|
r r Nr )Úsuccessr r )r rr rQ r rt Zcheck_responser¤ r; )r{ r¥ r¦ r r- r- r. r ¤ s
|
|
|
zWebDriver.execute)ÚurlrX c C s | tjd|i¡ dS )z0Loads a web page in the current browser session.r¨ N)r r ÚGET)r{ r¨ r- r- r. r; ¿ s z WebDriver.getc C s | tj¡ dd¡S )zuReturns the title of the current page.
|
|
:Usage:
|
::
|
|
title = driver.title
|
r Ú )r r Z GET_TITLEr; r r- r- r. Útitleà s zWebDriver.title)ÚscriptrX c C s t |}|| j|j< |S )zUStore common javascript scripts to be executed later by a unique
|
hashable ID.)r# rs r )r{ r¬ Ú
|
script_keyZscript_key_instancer- r- r. Ú
|
pin_scriptÎ s zWebDriver.pin_script)r rX c C sD z| j |j¡ W n, tk
|
r> td| d| j dY nX dS )z$Remove a pinned script from storage.zNo script with key: z existed in N)rs Úpopr r )r{ r r- r- r. ÚunpinÕ s zWebDriver.unpinc C s
|
t | jS r )rm rs r r- r- r. Úget_pinned_scriptsÜ s z WebDriver.get_pinned_scriptsc G s\ t |tr8z| j|j }W n tk
|
r6 tdY nX t|}tj}| |||d¡d S )a' 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 found©r¬ r r )
|
rl r# rs r r r rm r ZW3C_EXECUTE_SCRIPTr ©r{ r¬ r Zconverted_argsÚcommandr- r- r. Úexecute_scriptß s
|
zWebDriver.execute_script)r¬ c G s$ t |}tj}| |||d¡d S )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)
|
r² r )rm r ZW3C_EXECUTE_SCRIPT_ASYNCr r³ r- r- r. Úexecute_async_scriptö s z WebDriver.execute_async_scriptc C s | tj¡d S )znGets the URL of the current page.
|
|
:Usage:
|
::
|
|
driver.current_url
|
r )r r ZGET_CURRENT_URLr r- r- r. Ú current_url s zWebDriver.current_urlc C s | tj¡d S )zqGets the source of the current page.
|
|
:Usage:
|
::
|
|
driver.page_source
|
r )r r ZGET_PAGE_SOURCEr r- r- r. Ú page_source s zWebDriver.page_sourcec C s | tj¡ dS )zcCloses the current window.
|
|
:Usage:
|
::
|
|
driver.close()
|
N)r r ZCLOSEr r- r- r. Úclose s zWebDriver.closec C s* z| tj¡ W 5 | ¡ | j ¡ X dS )z|Quits the driver and closes every associated window.
|
|
:Usage:
|
::
|
|
driver.quit()
|
N)r rQ r¹ r r ZQUITr r- r- r. r ) s zWebDriver.quitc C s | tj¡d S )zReturns the handle of the current window.
|
|
:Usage:
|
::
|
|
driver.current_window_handle
|
r )r r Z W3C_GET_CURRENT_WINDOW_HANDLEr r- r- r. Úcurrent_window_handle7 s z WebDriver.current_window_handlec C s | tj¡d S )zReturns the handles of all windows within the current session.
|
|
:Usage:
|
::
|
|
driver.window_handles
|
r )r r ZW3C_GET_WINDOW_HANDLESr r- r- r. Úwindow_handlesB s zWebDriver.window_handlesc C s t j}| |d¡ dS )z5Maximizes the current window that webdriver is using.N)r ZW3C_MAXIMIZE_WINDOWr )r{ r´ r- r- r. Úmaximize_windowM s zWebDriver.maximize_windowc C s | tj¡ dS )z<Invokes the window manager-specific 'full screen' operation.N)r r ZFULLSCREEN_WINDOWr r- r- r. Úfullscreen_windowR s zWebDriver.fullscreen_windowc C s | tj¡ dS )z9Invokes the window manager-specific 'minimize' operation.N)r r ZMINIMIZE_WINDOWr r- r- r. Úminimize_windowV s zWebDriver.minimize_window)Ú print_optionsrX c C s" i }|r| ¡ }| tj|¡d S )zTakes PDF of the current page.
|
|
The driver makes a best effort to return a PDF based on the
|
provided parameters.
|
r )Úto_dictr r Z
|
PRINT_PAGE)r{ r¿ rW r- r- r. Ú
|
print_pageZ s zWebDriver.print_pagec C s | j S )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')
|
)ru r r- r- r. Ú switch_tof s zWebDriver.switch_toc C s | tj¡ dS )zvGoes one step backward in the browser history.
|
|
:Usage:
|
::
|
|
driver.back()
|
N)r r ZGO_BACKr r- r- r. Úback{ s zWebDriver.backc C s | tj¡ dS )zxGoes one step forward in the browser history.
|
|
:Usage:
|
::
|
|
driver.forward()
|
N)r r Z
|
GO_FORWARDr r- r- r. Úforward
s zWebDriver.forwardc C s | tj¡ dS )zfRefreshes the current page.
|
|
:Usage:
|
::
|
|
driver.refresh()
|
N)r r ZREFRESHr r- r- r. Úrefresh s zWebDriver.refreshc C s | tj¡d S )z®Returns a set of dictionaries, corresponding to cookies visible in
|
the current session.
|
|
:Usage:
|
::
|
|
driver.get_cookies()
|
r )r r ZGET_ALL_COOKIESr r- r- r. Ú get_cookies s zWebDriver.get_cookiesc
|
C s8 t t¡$ | tjd|i¡d W 5 Q R £ S Q R X dS )z§Get a single cookie by name. Returns the cookie if found, None if
|
not.
|
|
:Usage:
|
::
|
|
driver.get_cookie('my_cookie')
|
r r N)Ú
|
contextlibÚsuppressr r r Z
|
GET_COOKIE©r{ r r- r- r. Ú
|
get_cookie¥ s (zWebDriver.get_cookiec C s | tjd|i¡ dS )zDeletes a single cookie with the given name.
|
|
:Usage:
|
::
|
|
driver.delete_cookie('my_cookie')
|
r N)r r Z DELETE_COOKIErÉ r- r- r. Ú delete_cookie² s zWebDriver.delete_cookiec C s | tj¡ dS )z
Delete all cookies in the scope of the session.
|
|
:Usage:
|
::
|
|
driver.delete_all_cookies()
|
N)r r ZDELETE_ALL_COOKIESr r- r- r. Údelete_all_cookies¼ s z WebDriver.delete_all_cookiesc C sB d|kr,|d dkst | tjd|i¡ n| tjd|i¡ dS )aA 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)ZStrictZLaxÚNoneÚcookieN)ÚAssertionErrorr r Z
|
ADD_COOKIE)r{ Ú cookie_dictr- r- r. Ú
|
add_cookieÆ s zWebDriver.add_cookie)Ú time_to_waitrX c C s" | tjdtt|d i¡ dS )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)
|
Úimplicitéè N©r r Ú SET_TIMEOUTSÚintÚfloat©r{ rÒ r- r- r. Úimplicitly_waitÚ s zWebDriver.implicitly_waitc C s" | tjdtt|d i¡ dS )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)
|
r¬ rÔ NrÕ rÙ r- r- r. Úset_script_timeoutê s z WebDriver.set_script_timeoutc C sX z"| tjdtt|d i¡ W n0 tk
|
rR | tjt|d dd¡ Y nX dS )zû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)
|
ÚpageLoadrÔ z page load)Úmsr N)r r rÖ r× rØ r rÙ r- r- r. Úset_page_load_timeoutø s "z WebDriver.set_page_load_timeoutc C sP | tj¡d }| d¡d |d< | d¡d |d< | d¡d |d< tf |S )z Get all the timeouts that have been set on the current session.
|
|
:Usage:
|
::
|
driver.timeouts
|
:rtype: Timeout
|
r rÓ rÔ Z implicit_waitrÜ Z page_loadr¬ )r r Z GET_TIMEOUTSr¯ r )r{ r) r- r- r. r) s
|
zWebDriver.timeoutsc C s | 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
|
r N)r r rÖ Z_to_json)r{ r) Ú_r- r- r. r) s )r rX c C s¢ t |tr4| j||d}|s,td|j |d S |tjkrRtj}d| d}n8|tjkrntj}d| }n |tj krtj}d| d}|
|
t j ||d¡d S )
|
z²Find an element given a By strategy and locator.
|
|
:Usage:
|
::
|
|
element = driver.find_element(By.ID, 'foo')
|
|
:rtype: WebElement
|
)Úbyr z%Cannot locate relative element with: r ú[id="ú"]r ú[name="©Zusingr r ) rl r Ú find_elementsr Úrootr ÚIDÚ CSS_SELECTORÚ
|
CLASS_NAMEÚNAMEr r Z FIND_ELEMENT)r{ rà r Úelementsr- r- r. Ú find_element% s
|
|
|
|
|
zWebDriver.find_elementc C s t |trPd t d¡dd
¡}t |d¡ d¡}d| d}| || ¡ ¡S |t
|
j krnt
|
j }d| d }n8|t
|
j krt
|
j }d| }n |t
|
jkr¦t
|
j }d
|
| d }| tj||d ¡d pÀg S ) zÂFind elements given a By strategy and locator.
|
|
:Usage:
|
::
|
|
elements = driver.find_elements(By.CLASS_NAME, 'foo')
|
|
:rtype: list of WebElement
|
r NéÿÿÿÿzfindElements.jsÚutf8z/* findElements */return (z).apply(null, arguments);rá râ rã rä r )rl r Újoinre ÚsplitÚpkgutilÚget_dataÚdecoderµ rÀ r rç rè ré rê r r Z FIND_ELEMENTS)r{ rà r Z_pkgZ raw_functionZfind_element_jsr- r- r. rå A s
|
|
|
|
|
zWebDriver.find_elementsc C s t jdtdd | jS )z<returns the drivers current desired capabilities being used.z=desired_capabilities is deprecated. Please call capabilities.r1 r2 )r? r@ rA rC r r- r- r. r| _ s z WebDriver.desired_capabilitiesc C s | j S )z4returns the drivers current capabilities being used.)rC r r- r- r. rM e s zWebDriver.capabilitiesc C st t | ¡ d¡s t dt¡ | ¡ }zDz$t|d}| |¡ W 5 Q R X W n t k
|
rf Y W ¢
|
dS X W 5 ~X dS )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` extensionÚwbFT)
|
rp r< Úendswithr? r@ Ú UserWarningÚget_screenshot_as_pngÚopenÚwriteÚOSError)r{ ÚfilenameZpngÚfr- r- r. Úget_screenshot_as_filej s þ z WebDriver.get_screenshot_as_filec C s
|
| |¡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û r- r- r. Úsave_screenshot s zWebDriver.save_screenshotc C s t | ¡ d¡S )zGets the screenshot of the current window as a binary data.
|
|
:Usage:
|
::
|
|
driver.get_screenshot_as_png()
|
Úascii)r Úget_screenshot_as_base64Úencoder r- r- r. r÷ s z WebDriver.get_screenshot_as_pngc C s | tj¡d S )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 )r r Z
|
SCREENSHOTr r- r- r. r ¡ s z"WebDriver.get_screenshot_as_base64Úcurrent)Ú windowHandlerX c C s, |dkrt d¡ | jt|t|d dS )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.©ÚwidthÚheightN©r? r@ Úset_window_rectr× )r{ r r r r- r- r. Úset_window_size¬ s
|
zWebDriver.set_window_sizec s@ |dkrt d¡ | ¡ dd¡r. d fdddD S )zGets the width and height of the current window.
|
|
:Usage:
|
::
|
|
driver.get_window_size()
|
r r r Nc s i | ]}| | qS r- r- ©rJ rD ©Úsizer- r. Ú
|
<dictcomp>Ì s z-WebDriver.get_window_size.<locals>.<dictcomp>r )r? r@ Úget_window_rectr; ©r{ r r- r r. Úget_window_size¼ s
|
zWebDriver.get_window_sizec C s( |dkrt d¡ | jt|t|dS )a. 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)
|
r r ©ÚxÚyr )r{ r r r r- r- r. Úset_window_positionÎ s
|
z WebDriver.set_window_positionc s, |dkrt d¡ | ¡ fdddD S )zGets the x,y position of the current window.
|
|
:Usage:
|
::
|
|
driver.get_window_position()
|
r r c s i | ]}| | qS r- r- r ©Úpositionr- r. r ë s z1WebDriver.get_window_position.<locals>.<dictcomp>r )r? r@ r r r- r r. Úget_window_positionÞ s
|
z WebDriver.get_window_positionc C s | tj¡d S )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 )r r ZGET_WINDOW_RECTr r- r- r. r í s zWebDriver.get_window_rectc C s< |dkr |dkr |s |s t d| tj||||d¡d S )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 r r r )r r r ZSET_WINDOW_RECT)r{ r r r r r- r- r. r ø s zWebDriver.set_window_rectc C s | j S r )Ú_file_detectorr r- r- r. rw s zWebDriver.file_detectorc C s( |s t dt|ts t d|| _dS )a0 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)r rl r r )r{ Údetectorr- r- r. rw s
|
|
c C s | tj¡d S )zGets the current orientation of the device.
|
|
:Usage:
|
::
|
|
orientation = driver.orientation
|
r )r r ZGET_SCREEN_ORIENTATIONr r- r- r. Ú orientation! s zWebDriver.orientationc C s4 ddg}| ¡ |kr(| tjd|i¡ ntddS )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)Úupperr r ZSET_SCREEN_ORIENTATIONr )r{ r Zallowed_valuesr- r- r. r , s c C s t | S )zQReturns a ApplicationCache Object to interact with the browser app
|
cache.r r r- r- r. Úapplication_cache> s zWebDriver.application_cachec C s | tj¡d S )z§Gets a list of the available log types. This only works with w3c
|
compliant browsers.
|
|
:Usage:
|
::
|
|
driver.log_types
|
r )r r ZGET_AVAILABLE_LOG_TYPESr r- r- r. Ú log_typesD s
|
zWebDriver.log_typesc C s | tjd|i¡d S )a> 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')
|
r r )r r ZGET_LOG)r{ Zlog_typer- r- r. Úget_logP s zWebDriver.get_logc C sÒ t | j d¡r6| j d¡}| j d¡ d¡d }n | ¡ \}}|sNtdt |¡}t |¡4 I d H X}| |j
|
¡ ¡I d H }|d j }| |¡4 I d H }t|t|V W 5 Q I d H R X W 5 Q I d H R X d S )Nzse:cdpz se:cdpVersionr r z2Unable to find url to connect to from capabilities)r/ rC r; rð Ú_get_cdp_detailsr r, Zimport_devtoolsZopen_cdpr ÚtargetZ get_targetsÚ target_idZ open_sessionr )r{ Zws_urlr* ZdevtoolsÚconnÚtargetsr" Úsessionr- r- r. Úbidi_connection` s
|
|
zWebDriver.bidi_connectionc C sÆ dd l }dd l}| ¡ }d}| j d¡dkrV| j | j d| j d¡ d¡ d¡}nd}| j d ¡}| d
|
d | d ¡}| |j¡}| d ¡}| d¡} dd l }
|
|r¬d} n|
|
|
d|¡ d¡} | | fS )Nr Fr' Zchromer4 ÚOptionsZdebuggerAddressTzmoz:debuggerAddressr© zhttp://z /json/versionZBrowserZwebSocketDebuggerUrléU z
|
.*/(\d+)\.r ) ÚjsonÚurllib3Ú PoolManagerrC r; Z vendor_prefixÚrequestÚloadsÚdataÚreÚsearchÚgroup) r{ r) r* ÚhttpZ_firefoxZdebugger_addressÚresr. Zbrowser_versionZ websocket_urlr/ r* r- r- r. r t s& "ÿ
|
|
zWebDriver._get_cdp_detailsc C s | tj| ¡ ¡d | _dS )z4Adds a virtual authenticator with the given options.r N)r r ZADD_VIRTUAL_AUTHENTICATORrÀ rx )r{ rW r- r- r. Úadd_virtual_authenticator s z#WebDriver.add_virtual_authenticatorc C s | j S )z,Returns the id of the virtual authenticator.)rx r r- r- r. Úvirtual_authenticator_id s z"WebDriver.virtual_authenticator_idc C s | tjd| ji¡ d| _dS )zRemoves a previously added virtual authenticator.
|
|
The authenticator is no longer valid after removal, so no
|
methods may be called.
|
ÚauthenticatorIdN)r r Z REMOVE_VIRTUAL_AUTHENTICATORrx r r- r- r. Ú remove_virtual_authenticator s z&WebDriver.remove_virtual_authenticator)Ú
|
credentialrX c C s | tj| ¡ d| ji¡ dS )z,Injects a credential into the authenticator.r6 N)r r ZADD_CREDENTIALrÀ rx )r{ r8 r- r- r. Úadd_credential§ s zWebDriver.add_credentialc C s& | tjd| ji¡}dd |d D S )z;Returns the list of credentials owned by the authenticator.r6 c S s g | ]}t |¡qS r- )r Ú from_dict)rJ r8 r- r- r. Ú
|
<listcomp>° s z-WebDriver.get_credentials.<locals>.<listcomp>r )r r ZGET_CREDENTIALSrx )r{ Zcredential_datar- r- r. Úget_credentials¬ s zWebDriver.get_credentials)Ú credential_idrX c C s0 t |trt| ¡ }| tj|| jd¡ dS )z,Removes a credential from the authenticator.)Z credentialIdr6 N)rl Ú bytearrayr ró r r ZREMOVE_CREDENTIALrx )r{ r= r- r- r. Úremove_credential² s
|
|
ÿzWebDriver.remove_credentialc C s | tjd| ji¡ dS )z/Removes all credentials from the authenticator.r6 N)r r ZREMOVE_ALL_CREDENTIALSrx r r- r- r. Úremove_all_credentials½ s z WebDriver.remove_all_credentials)ÚverifiedrX c C s | tj| j|d¡ dS )z¾Sets whether the authenticator will simulate success or fail on user
|
verification.
|
|
verified: True if the authenticator will pass user verification, False otherwise.
|
)r6 ZisUserVerifiedN)r r ZSET_USER_VERIFIEDrx )r{ rA r- r- r. Úset_user_verified s zWebDriver.set_user_verified)rk NNNTNN)N)N)N)N)r )r )r )r )NNNN)pre rf rg rh r& r r$ r r r r r~ r r
Útypingr
|
ÚTypeÚ BaseExceptionÚtypesÚ TracebackTyper r r Úpropertyr! r rp r ry r ro rz r r£ r¤ r r; r« r# r® r° r± rµ r¶ r· r¸ r¹ r rº r» r¼ r½ r¾ r rÁ r% r rà rÄ rÅ rÆ r rÊ rË rÌ rÑ rØ rÚ rÛ rÞ r r) Úsetterr rç rì rå r| rM Úboolrý rþ rq r÷ r r
|
r r r r r r rw r r r r r r& r r r4 r5 r r7 r r9 r< r> r? r@ rB r- r- r- r. rj º sî ø÷ V
|
ü
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
rj )F)Irh rÇ r9 rñ rF rC r? Úabcr Úbase64r r r r Ú importlibr r r r
|
r Zselenium.common.exceptionsr r r r r Z selenium.webdriver.common.byr Z1selenium.webdriver.common.html5.application_cacher Z!selenium.webdriver.common.optionsr Z,selenium.webdriver.common.print_page_optionsr Z"selenium.webdriver.common.timeoutsr Z/selenium.webdriver.common.virtual_authenticatorr r r Z+selenium.webdriver.support.relative_locatorr r& r r´ r Z errorhandlerr rw r r r r! Zremote_connectionr" r r# Z
|
shadowrootr$ r r% Z
|
webelementr& Ú frozensetrB r> r, r/ rF rU rc rd rj r- r- r- r. Ú<module> s~ õÿ )
|
"
|
