1# Copyright 2015 The Chromium OS Authors. All rights reserved. 2# Use of this source code is governed by a BSD-style license that can be 3# found in the LICENSE file. 4 5"""An adapter to remotely access the browser facade on DUT.""" 6 7 8class BrowserFacadeRemoteAdapter(object): 9 """BrowserFacadeRemoteAdapter is an adapter to remotely control DUT browser. 10 11 The Autotest host object representing the remote DUT, passed to this 12 class on initialization, can be accessed from its _client property. 13 14 """ 15 def __init__(self, remote_facade_proxy): 16 """Construct an BrowserFacadeRemoteAdapter. 17 18 @param remote_facade_proxy: RemoteFacadeProxy object. 19 20 """ 21 self._proxy = remote_facade_proxy 22 23 24 @property 25 def _browser_proxy(self): 26 """Gets the proxy to DUT browser facade. 27 28 @return XML RPC proxy to DUT browser facade. 29 30 """ 31 return self._proxy.browser 32 33 34 def start_custom_chrome(self, kwargs): 35 """Start a custom Chrome with given arguments. 36 37 @param kwargs: A dict of keyword arguments passed to Chrome. 38 @return: True on success, False otherwise. 39 40 """ 41 return self._browser_proxy.start_custom_chrome(kwargs) 42 43 44 def start_default_chrome(self, restart=False, extra_browser_args=None): 45 """Start the default Chrome. 46 47 @param restart: True to start Chrome without clearing previous state. 48 @param extra_browser_args: A list containing extra browser args passed 49 to Chrome in addition to default ones. 50 @return: True on success, False otherwise. 51 52 """ 53 return self._browser_proxy.start_default_chrome( 54 restart, extra_browser_args) 55 56 57 def set_http_server_directories(self, directories): 58 """Starts an HTTP server. 59 60 @param directories: Directories to start serving. 61 62 @return True on success. False otherwise. 63 64 """ 65 return self._browser_proxy.set_http_server_directories(directories) 66 67 68 def http_server_url_of(self, fullpath): 69 """Converts a path to a URL. 70 71 @param fullpath: String containing the full path to the content. 72 73 @return the URL for the provided path. 74 75 """ 76 return self._browser_proxy.http_server_url_of(fullpath) 77 78 79 def new_tab(self, url): 80 """Opens a new tab and loads URL. 81 82 @param url: The URL to load. 83 @return a str, the tab descriptor of the opened tab. 84 85 """ 86 return self._browser_proxy.new_tab(url) 87 88 89 def close_tab(self, tab_descriptor): 90 """Closes a previously opened tab. 91 92 @param tab_descriptor: Indicate which tab to be closed. 93 94 """ 95 self._browser_proxy.close_tab(tab_descriptor) 96 97 98 def wait_for_javascript_expression( 99 self, tab_descriptor, expression, timeout): 100 """Waits for the given JavaScript expression to be True on the given tab 101 102 @param tab_descriptor: Indicate on which tab to wait for the expression. 103 @param expression: Indiate for what expression to wait. 104 @param timeout: Indicate the timeout of the expression. 105 """ 106 self._browser_proxy.wait_for_javascript_expression( 107 tab_descriptor, expression, timeout) 108 109 110 def execute_javascript(self, tab_descriptor, statement, timeout): 111 """Executes a JavaScript statement on the given tab. 112 113 @param tab_descriptor: Indicate on which tab to execute the statement. 114 @param statement: Indiate what statement to execute. 115 @param timeout: Indicate the timeout of the statement. 116 """ 117 self._browser_proxy.execute_javascript( 118 tab_descriptor, statement, timeout) 119 120 121 def evaluate_javascript(self, tab_descriptor, expression, timeout): 122 """Evaluates a JavaScript expression on the given tab. 123 124 @param tab_descriptor: Indicate on which tab to evaluate the expression. 125 @param expression: Indiate what expression to evaluate. 126 @param timeout: Indicate the timeout of the expression. 127 @return the JSONized result of the given expression 128 """ 129 return self._browser_proxy.evaluate_javascript( 130 tab_descriptor, expression, timeout) 131