B h @s dZddlZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m Z dd lmZdd lmZdd lmZmZdd lmZmZmZdd lmZddlmZyeZWnek rYnXe dddddddddg Z!ddddZ"ddZ#Gddde$Z%dS)zThe WebDriver implementation.N)contextmanager)Command) WebElement)RemoteConnection) ErrorHandler)SwitchTo)Mobile) FileDetectorLocalFileDetector)InvalidArgumentExceptionWebDriverExceptionNoSuchCookieException)By)ApplicationCacheacceptInsecureCerts browserNamebrowserVersionZ platformNameZpageLoadStrategyproxyZ setWindowRectZtimeoutsZunhandledPromptBehavior)ZacceptSslCertsversionplatformcCst|}|d}i}|drH|ddrH|dd|dd<xT|D]H\}}|r|tkr|dkrv|n||t|<|tksd|krR|||<qRW|r|di}d|krt|}||d<||d<ig|dS) 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_profilerZ proxyTyper:zmoz:firefoxOptionsprofile)Z firstMatchZ alwaysMatch)copydeepcopygetloweritems_OSS_W3C_CONVERSION_W3C_CAPABILITY_NAMES)ZcapsrZ always_matchkvZmoz_optsZnew_optsr#`C:\Users\sanjo\AppData\Local\Qlobot\Launcher\ext_packages\selenium\webdriver\remote\webdriver.py_make_w3c_caps?s"      r%c@seZdZdZeZdddZddZd d Zd d Z e d dZ e ddZ e ddZddZddZdddZddZddZddZddd Zd!d"Ze d#d$Zd%d&Zd'd(Zd)d*Zd+d,Zd-d.Zd/d0Zd1d2Zd3d4Zd5d6Z d7d8Z!d9d:Z"d;d<Z#d=d>Z$d?d@Z%dAdBZ&dCdDZ'dEdFZ(dGdHZ)e dIdJZ*e dKdLZ+dMdNZ,dOdPZ-e dQdRZ.e dSdTZ/dUdVZ0dWdXZ1dYdZZ2e d[d\Z3d]d^Z4d_d`Z5dadbZ6dcddZ7dedfZ8dgdhZ9didjZ:dkdlZ;dmdnZdsdtZ?dudvZ@dwdxZAdydzZBd{d|ZCeDjEdfd}d~ZFeDjEdfddZGe ddZHddZIddZJddZKddZLdddZMdddZNdddZOdddZPddZQdddZRe ddZSeSjTddZSe ddZUeUjTddZUe ddZVe ddZWddZXdS) 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 - Dictionaty 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:4444/wd/hubNFc Csi}|dk r|}|dk r:t|ts0tdn |||dk r\tjdtdd||||_ t |j t ks|t|j t rt ||d|_ d|_d|_i|_t|_||dk rtjdtdd|||t||_t||_|pt|_dS) aY 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 False. - 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 Nz)Desired Capabilities must be a dictionaryz&Please use FirefoxOptions to set proxy) stacklevel) keep_aliveTz0Please use FirefoxOptions to set browser profile)to_capabilities isinstancedictr updatewarningswarnDeprecationWarningadd_to_capabilitiescommand_executortypebytesstrr _is_remote session_id capabilitiesr error_handler start_client start_sessionr _switch_tor _mobiler file_detector) selfr3desired_capabilitiesbrowser_profilerr*r?optionsr9r#r#r$__init__qs4         zWebDriver.__init__cCsdt||jS)Nz-<{0.__module__}.{0.__name__} (session="{1}")>)formatr4r8)r@r#r#r$__repr__szWebDriver.__repr__cCs|S)Nr#)r@r#r#r$ __enter__szWebDriver.__enter__cGs |dS)N)quit)r@argsr#r#r$__exit__szWebDriver.__exit__cosBd}t|j|s"|j}||||_z dVWd|dk r<||_XdS)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)r,r?)r@Zfile_detector_classrIkwargsZ last_detectorr#r#r$file_detector_contexts   zWebDriver.file_detector_contextcCs|jS)N)r>)r@r#r#r$mobileszWebDriver.mobilecCs d|jkr|jdStddS)zvReturns the name of the underlying browser for this instance. :Usage: name = driver.name rz1browserName not specified in session capabilitiesN)r9KeyError)r@r#r#r$names  zWebDriver.namecCsdS)z Called before starting a new session. This method may be overridden to define custom startup behavior. Nr#)r@r#r#r$r;szWebDriver.start_clientcCsdS)z Called after executing a quit command. This method may be overridden to define custom shutdown behavior. Nr#)r@r#r#r$ stop_clientszWebDriver.stop_clientcCst|tstd|r>d|kr.|j|dd<n|d|jit|}||d}|tj|}d|krn|d}|d|_ | d|_ |j dkr| d |_ | d dk|_ |j |j _ dS) a Creates a new session with the desired capabilities. :Args: - browser_name - The name of the browser to request. - version - Which browser version to request. - platform - Which platform to request the browser on. - javascript_enabled - Whether the new session should support JavaScript. - browser_profile - A selenium.webdriver.firefox.firefox_profile.FirefoxProfile object. Only used if Firefox is requested. z!Capabilities must be a dictionaryzmoz:firefoxOptionsrr)r9ZdesiredCapabilities sessionIdvalueNr9status)r,r-r encodedr.r%executerZ NEW_SESSIONr8rr9w3cr3)r@r9rBZw3c_caps parametersresponser#r#r$r<s$     zWebDriver.start_sessioncsxt|tr6i}x"|D]\}}|||<qW|St|jrP|j|jdSt|trptfdd|DS|SdS)N)ELEMENTz#element-6066-11e4-a52e-4f735466cecfc3s|]}|VqdS)N) _wrap_value).0item)r@r#r$ sz(WebDriver._wrap_value..)r,r-rrZ_web_element_clsidlist)r@rRZ convertedkeyvalr#)r@r$rZ s   zWebDriver._wrap_valuecCs|j|||jdS)z6Creates a web element with the specified `element_id`.)rV)r^rV)r@Z element_idr#r#r$create_web_elementszWebDriver.create_web_elementcst|trrd|ksd|krH|dd}|r8|dS|dSqx"|D]\}}|||<qRW|Sn$t|trtfdd|DS|SdS)NrYz#element-6066-11e4-a52e-4f735466cecfc3s|]}|VqdS)N) _unwrap_value)r[r\)r@r#r$r])sz*WebDriver._unwrap_value..)r,r-rrcrrdr`)r@rRZ wrapped_idrarbr#)r@r$rds   zWebDriver._unwrap_valuecCs||jdk r,|sd|ji}nd|kr,|j|d<||}|j||}|rn|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. NrQrRr)ZsuccessrRrQ)r8rZr3rUr:Zcheck_responserdr)r@Zdriver_commandparamsrXr#r#r$rU-s     zWebDriver.executecCs|tjd|idS)zB Loads a web page in the current browser session. urlN)rUrGET)r@rfr#r#r$rIsz WebDriver.getcCs$|tj}|ddk r |dSdS)zaReturns the title of the current page. :Usage: title = driver.title rRN)rUrZ GET_TITLE)r@respr#r#r$titleOs zWebDriver.titlecCs|jtj|dS)aFFinds an element by id. :Args: - id\_ - The id of the element to be found. :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: element = driver.find_element_by_id('foo') )byrR) find_elementrID)r@id_r#r#r$find_element_by_idYszWebDriver.find_element_by_idcCs|jtj|dS)a; Finds multiple elements by id. :Args: - id\_ - The id of the elements to be found. :Returns: - list of WebElement - a list with elements if any was found. An empty list if not :Usage: elements = driver.find_elements_by_id('foo') )rkrR) find_elementsrrm)r@rnr#r#r$find_elements_by_idjszWebDriver.find_elements_by_idcCs|jtj|dS)ae Finds an element by xpath. :Args: - xpath - The xpath locator of the element to find. :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: element = driver.find_element_by_xpath('//div/td[1]') )rkrR)rlrXPATH)r@xpathr#r#r$find_element_by_xpathzszWebDriver.find_element_by_xpathcCs|jtj|dS)ah Finds multiple elements by xpath. :Args: - xpath - The xpath locator of the elements to be found. :Returns: - list of WebElement - a list with elements if any was found. An empty list if not :Usage: elements = driver.find_elements_by_xpath("//div[contains(@class, 'foo')]") )rkrR)rprrr)r@rsr#r#r$find_elements_by_xpathsz WebDriver.find_elements_by_xpathcCs|jtj|dS)ag Finds an element by link text. :Args: - link_text: The text of the element to be found. :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: element = driver.find_element_by_link_text('Sign In') )rkrR)rlr LINK_TEXT)r@ link_textr#r#r$find_element_by_link_textsz#WebDriver.find_element_by_link_textcCs|jtj|dS)aJ Finds elements by link text. :Args: - link_text: The text of the elements to be found. :Returns: - list of webelement - a list with elements if any was found. an empty list if not :Usage: elements = driver.find_elements_by_link_text('Sign In') )rkrR)rprrv)r@textr#r#r$find_elements_by_link_textsz$WebDriver.find_elements_by_link_textcCs|jtj|dS)a Finds an element by a partial match of its link text. :Args: - link_text: The text of the element to partially match on. :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: element = driver.find_element_by_partial_link_text('Sign') )rkrR)rlrPARTIAL_LINK_TEXT)r@rwr#r#r$!find_element_by_partial_link_textsz+WebDriver.find_element_by_partial_link_textcCs|jtj|dS)ao Finds elements by a partial match of their link text. :Args: - link_text: The text of the element to partial match on. :Returns: - list of webelement - a list with elements if any was found. an empty list if not :Usage: elements = driver.find_elements_by_partial_link_text('Sign') )rkrR)rprr{)r@rwr#r#r$"find_elements_by_partial_link_textsz,WebDriver.find_elements_by_partial_link_textcCs|jtj|dS)aP Finds an element by name. :Args: - name: The name of the element to find. :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: element = driver.find_element_by_name('foo') )rkrR)rlrNAME)r@rOr#r#r$find_element_by_nameszWebDriver.find_element_by_namecCs|jtj|dS)a3 Finds elements by name. :Args: - name: The name of the elements to find. :Returns: - list of webelement - a list with elements if any was found. an empty list if not :Usage: elements = driver.find_elements_by_name('foo') )rkrR)rprr~)r@rOr#r#r$find_elements_by_nameszWebDriver.find_elements_by_namecCs|jtj|dS)aZ Finds an element by tag name. :Args: - name - name of html tag (eg: h1, a, span) :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: element = driver.find_element_by_tag_name('h1') )rkrR)rlrTAG_NAME)r@rOr#r#r$find_element_by_tag_namesz"WebDriver.find_element_by_tag_namecCs|jtj|dS)a< Finds elements by tag name. :Args: - name - name of html tag (eg: h1, a, span) :Returns: - list of WebElement - a list with elements if any was found. An empty list if not :Usage: elements = driver.find_elements_by_tag_name('h1') )rkrR)rprr)r@rOr#r#r$find_elements_by_tag_namesz#WebDriver.find_elements_by_tag_namecCs|jtj|dS)ab Finds an element by class name. :Args: - name: The class name of the element to find. :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: element = driver.find_element_by_class_name('foo') )rkrR)rlr CLASS_NAME)r@rOr#r#r$find_element_by_class_name$sz$WebDriver.find_element_by_class_namecCs|jtj|dS)aE Finds elements by class name. :Args: - name: The class name of the elements to find. :Returns: - list of WebElement - a list with elements if any was found. An empty list if not :Usage: elements = driver.find_elements_by_class_name('foo') )rkrR)rprr)r@rOr#r#r$find_elements_by_class_name6sz%WebDriver.find_elements_by_class_namecCs|jtj|dS)ao Finds an element by css selector. :Args: - css_selector - CSS selector string, ex: 'a.nav#home' :Returns: - WebElement - the element if it was found :Raises: - NoSuchElementException - if the element wasn't found :Usage: element = driver.find_element_by_css_selector('#foo') )rkrR)rlr CSS_SELECTOR)r@ css_selectorr#r#r$find_element_by_css_selectorFsz&WebDriver.find_element_by_css_selectorcCs|jtj|dS)aQ Finds elements by css selector. :Args: - css_selector - CSS selector string, ex: 'a.nav#home' :Returns: - list of WebElement - a list with elements if any was found. An empty list if not :Usage: elements = driver.find_elements_by_css_selector('.foo') )rkrR)rprr)r@rr#r#r$find_elements_by_css_selectorXsz'WebDriver.find_elements_by_css_selectorcGs6t|}d}|jrtj}ntj}||||ddS)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;') N)scriptrIrR)r`rVrZW3C_EXECUTE_SCRIPTZEXECUTE_SCRIPTrU)r@rrIconverted_argscommandr#r#r$execute_scripths zWebDriver.execute_scriptcGs2t|}|jrtj}ntj}||||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) )rrIrR)r`rVrZW3C_EXECUTE_SCRIPT_ASYNCZEXECUTE_ASYNC_SCRIPTrU)r@rrIrrr#r#r$execute_async_script~s zWebDriver.execute_async_scriptcCs|tjdS)zc Gets the URL of the current page. :Usage: driver.current_url rR)rUrZGET_CURRENT_URL)r@r#r#r$ current_urlszWebDriver.current_urlcCs|tjdS)zf Gets the source of the current page. :Usage: driver.page_source rR)rUrZGET_PAGE_SOURCE)r@r#r#r$ page_sourceszWebDriver.page_sourcecCs|tjdS)zX Closes the current window. :Usage: driver.close() N)rUrZCLOSE)r@r#r#r$closeszWebDriver.closecCs z|tjWd|XdS)zq Quits the driver and closes every associated window. :Usage: driver.quit() N)rUrZQUITrP)r@r#r#r$rHszWebDriver.quitcCs*|jr|tjdS|tjdSdS)zu Returns the handle of the current window. :Usage: driver.current_window_handle rRN)rVrUrZW3C_GET_CURRENT_WINDOW_HANDLEZGET_CURRENT_WINDOW_HANDLE)r@r#r#r$current_window_handleszWebDriver.current_window_handlecCs*|jr|tjdS|tjdSdS)z Returns the handles of all windows within the current session. :Usage: driver.window_handles rRN)rVrUrZW3C_GET_WINDOW_HANDLESZGET_WINDOW_HANDLES)r@r#r#r$window_handlesszWebDriver.window_handlescCs.d}tj}|jstj}ddi}|||dS)zF Maximizes the current window that webdriver is using N windowHandlecurrent)rZW3C_MAXIMIZE_WINDOWrVZMAXIMIZE_WINDOWrU)r@rerr#r#r$maximize_windows zWebDriver.maximize_windowcCs|tjdS)zM Invokes the window manager-specific 'full screen' operation N)rUrZFULLSCREEN_WINDOW)r@r#r#r$fullscreen_windowszWebDriver.fullscreen_windowcCs|tjdS)zJ Invokes the window manager-specific 'minimize' operation N)rUrZMINIMIZE_WINDOW)r@r#r#r$minimize_windowszWebDriver.minimize_windowcCs|jS)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') )r=)r@r#r#r$ switch_toszWebDriver.switch_tocCstjdtdd|jjS)z8 Deprecated use driver.switch_to.active_element z+use driver.switch_to.active_element insteadr()r))r/r0r1r=Zactive_element)r@r#r#r$switch_to_active_elements z"WebDriver.switch_to_active_elementcCs tjdtdd|j|dS)z0 Deprecated use driver.switch_to.window z#use driver.switch_to.window insteadr()r)N)r/r0r1r=Zwindow)r@Z window_namer#r#r$switch_to_window s zWebDriver.switch_to_windowcCs tjdtdd|j|dS)z/ Deprecated use driver.switch_to.frame z"use driver.switch_to.frame insteadr()r)N)r/r0r1r=frame)r@Zframe_referencer#r#r$switch_to_frames zWebDriver.switch_to_framecCstjdtdd|jdS)z9 Deprecated use driver.switch_to.default_content z,use driver.switch_to.default_content insteadr()r)N)r/r0r1r=Zdefault_content)r@r#r#r$switch_to_default_contents z#WebDriver.switch_to_default_contentcCstjdtdd|jjS)z/ Deprecated use driver.switch_to.alert z"use driver.switch_to.alert insteadr()r))r/r0r1r=Zalert)r@r#r#r$switch_to_alerts zWebDriver.switch_to_alertcCs|tjdS)zk Goes one step backward in the browser history. :Usage: driver.back() N)rUrZGO_BACK)r@r#r#r$back&szWebDriver.backcCs|tjdS)zm Goes one step forward in the browser history. :Usage: driver.forward() N)rUrZ GO_FORWARD)r@r#r#r$forward/szWebDriver.forwardcCs|tjdS)z[ Refreshes the current page. :Usage: driver.refresh() N)rUrZREFRESH)r@r#r#r$refresh8szWebDriver.refreshcCs|tjdS)z Returns a set of dictionaries, corresponding to cookies visible in the current session. :Usage: driver.get_cookies() rR)rUrZGET_ALL_COOKIES)r@r#r#r$ get_cookiesBszWebDriver.get_cookiescCsb|jr4y|tjd|idStk r0dSXn*|}x|D]}|d|krB|SqBWdSdS)z Get a single cookie by name. Returns the cookie if found, None if not. :Usage: driver.get_cookie('my_cookie') rOrRN)rVrUrZ GET_COOKIErr)r@rOcookiescookier#r#r$ get_cookieKs  zWebDriver.get_cookiecCs|tjd|idS)z} Deletes a single cookie with the given name. :Usage: driver.delete_cookie('my_cookie') rON)rUrZ DELETE_COOKIE)r@rOr#r#r$ delete_cookie^szWebDriver.delete_cookiecCs|tjdS)zz Delete all cookies in the scope of the session. :Usage: driver.delete_all_cookies() N)rUrZDELETE_ALL_COOKIES)r@r#r#r$delete_all_cookiesgszWebDriver.delete_all_cookiescCs|tjd|idS)a Adds a cookie to your current session. :Args: - cookie_dict: A dictionary object, with required keys - "name" and "value"; optional keys - "path", "domain", "secure", "expiry" 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}) rN)rUrZ ADD_COOKIE)r@ cookie_dictr#r#r$ add_cookiepszWebDriver.add_cookiecCsD|jr&|tjdtt|din|tjdt|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) ZimplicitimsN)rVrUr SET_TIMEOUTSintfloatZ IMPLICIT_WAIT)r@ time_to_waitr#r#r$implicitly_waits zWebDriver.implicitly_waitcCsD|jr&|tjdtt|din|tjdt|didS)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) rirN)rVrUrrrrZSET_SCRIPT_TIMEOUT)r@rr#r#r$set_script_timeouts zWebDriver.set_script_timeoutc CsXy"|tjdtt|diWn0tk rR|tjt|dddYnXdS)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) ZpageLoadiz page load)rr4N)rUrrrrr )r@rr#r#r$set_page_load_timeouts  zWebDriver.set_page_load_timeoutcCs||jrd|tjkr tj}d|}nD|tjkr2tj}n2|tjkrLtj}d|}n|tjkrdtj}d|}|tj ||ddS)z Find an element given a By strategy and locator. Prefer the find_element_by_* methods when possible. :Usage: element = driver.find_element(By.ID, 'foo') :rtype: WebElement z [id="%s"]z.%sz [name="%s"])usingrRrR) rVrrmrrrr~rUrZ FIND_ELEMENT)r@rkrRr#r#r$rls       zWebDriver.find_elementcCs|jrd|tjkr tj}d|}nD|tjkr2tj}n2|tjkrLtj}d|}n|tjkrdtj}d|}|tj ||ddp~gS)z Find elements given a By strategy and locator. Prefer the find_elements_by_* methods when possible. :Usage: elements = driver.find_elements(By.CLASS_NAME, 'foo') :rtype: list of WebElement z [id="%s"]z.%sz [name="%s"])rrRrR) rVrrmrrrr~rUrZ FIND_ELEMENTS)r@rkrRr#r#r$rps       zWebDriver.find_elementscCs|jS)zM returns the drivers current desired capabilities being used )r9)r@r#r#r$rAszWebDriver.desired_capabilitiesc Csj|dstdt|}z>y$t|d}||WdQRXWntk r\dSXWd~XdS)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) rendswithr/r0 UserWarningget_screenshot_as_pngopenwriteIOError)r@filenameZpngfr#r#r$get_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@rr#r#r$save_screenshots zWebDriver.save_screenshotcCst|dS)z Gets the screenshot of the current window as a binary data. :Usage: driver.get_screenshot_as_png() ascii)base64 b64decodeget_screenshot_as_base64encode)r@r#r#r$r!szWebDriver.get_screenshot_as_pngcCs|tjdS)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() rR)rUrZ SCREENSHOT)r@r#r#r$r*sz"WebDriver.get_screenshot_as_base64rcCsR|jr0|dkrtd|jt|t|dn|tjt|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) rz@Only 'current' window is supported for W3C compatibile browsers.)widthheight)rrrN)rVr/r0set_window_rectrrUrZSET_WINDOW_SIZE)r@rrrr#r#r$set_window_size4s  zWebDriver.set_window_sizecsbtj}|jr(|dkrtd|n||d|idddk rPdfdddDS) zx Gets the width and height of the current window. :Usage: driver.get_window_size() rz@Only 'current' window is supported for W3C compatibile browsers.rrRNcsi|]}||qSr#r#)r[r!)sizer#r$ [sz-WebDriver.get_window_size..)rr)rZGET_WINDOW_SIZErVr/r0get_window_rectrUr)r@rrr#)rr$get_window_sizeIs  zWebDriver.get_window_sizecCsP|jr.|dkrtd|jt|t|dS|tjt|t||ddS)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) rz@Only 'current' window is supported for W3C compatibile browsers.)xy)rrrN)rVr/r0rrrUrZSET_WINDOW_POSITION)r@rrrr#r#r$set_window_position]s  zWebDriver.set_window_positioncsJ|jr"|dkrtd|n|tjd|idfdddDS)zx Gets the x,y position of the current window. :Usage: driver.get_window_position() rz@Only 'current' window is supported for W3C compatibile browsers.rrRcsi|]}||qSr#r#)r[r!)positionr#r$rsz1WebDriver.get_window_position..)rr)rVr/r0rrUrZGET_WINDOW_POSITION)r@rr#)rr$get_window_positionts  zWebDriver.get_window_positioncCs|tjdS)z Gets the x, y coordinates of the window as well as height and width of the current window. :Usage: driver.get_window_rect() rR)rUrZGET_WINDOW_RECT)r@r#r#r$rszWebDriver.get_window_rectcCsD|dkr(|dkr(|dkr(|dkr(td|tj||||ddS)a4 Sets the x, y coordinates of the window as well as height and width of the current window. :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)rrrrrR)r rUrZSET_WINDOW_RECT)r@rrrrr#r#r$rs  zWebDriver.set_window_rectcCs|jS)N)_file_detector)r@r#r#r$r?szWebDriver.file_detectorcCs,|dkrtdt|ts"td||_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. Nz,You may not set a file detector that is nullz+Detector has to be instance of FileDetector)r r,r r)r@detectorr#r#r$r?s  cCs|tjdS)zz Gets the current orientation of the device :Usage: orientation = driver.orientation rR)rUrZGET_SCREEN_ORIENTATION)r@r#r#r$ orientationszWebDriver.orientationcCs4ddg}||kr(|tjd|intddS)z Sets the current orientation of the device :Args: - value: orientation to set it to. :Usage: driver.orientation = 'landscape' Z LANDSCAPEZPORTRAITrz>You can only set the orientation to 'LANDSCAPE' and 'PORTRAIT'N)upperrUrZSET_SCREEN_ORIENTATIONr )r@rRZallowed_valuesr#r#r$rs  cCst|S)zI Returns a ApplicationCache Object to interact with the browser app cache)r)r@r#r#r$application_cacheszWebDriver.application_cachecCs|tjdS)zf Gets a list of the available log types :Usage: driver.log_types rR)rUrZGET_AVAILABLE_LOG_TYPES)r@r#r#r$ log_typesszWebDriver.log_typescCs|tjd|idS)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') r4rR)rUrZGET_LOG)r@Zlog_typer#r#r$get_logs zWebDriver.get_log)r'NNNFNN)N)N)r)r)r)r)NNNN)Y__name__ __module__ __qualname____doc__rr^rDrFrGrJrrLpropertyrMrOr;rPr<rZrcrdrUrrjrorqrtrurxrzr|r}rrrrrrrrrrrrrrHrrrrrrrrrrrrrrrrrrrrrrrrmrlrprArrrrrrrrrrr?setterrrrrr#r#r#r$r&`s  /    $                         r&)&rrrr/ contextlibrrr webelementrremote_connectionrZ errorhandlerrrrrMr r?r r Zselenium.common.exceptionsr r rZselenium.webdriver.common.byrZ1selenium.webdriver.common.html5.application_cacher basestringr6 NameError frozensetr rr%objectr&r#r#r#r$sB         !