1// Copyright 2013 The Chromium 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#ifndef CONTENT_SHELL_RENDERER_TEST_RUNNER_WEB_TEST_DELEGATE_H_ 6#define CONTENT_SHELL_RENDERER_TEST_RUNNER_WEB_TEST_DELEGATE_H_ 7 8#include <string> 9 10#include "third_party/WebKit/public/platform/WebScreenOrientationType.h" 11#include "third_party/WebKit/public/platform/WebString.h" 12#include "third_party/WebKit/public/platform/WebURL.h" 13#include "third_party/WebKit/public/platform/WebVector.h" 14#include "third_party/WebKit/public/web/WebNotificationPresenter.h" 15 16#define WEBTESTRUNNER_NEW_HISTORY_CAPTURE 17 18namespace blink { 19class WebBatteryStatus; 20class WebDeviceMotionData; 21class WebDeviceOrientationData; 22class WebFrame; 23class WebGamepad; 24class WebGamepads; 25class WebHistoryItem; 26struct WebRect; 27struct WebSize; 28struct WebURLError; 29} 30 31namespace content { 32 33class DeviceLightData; 34class RendererGamepadProvider; 35class WebTask; 36class WebTestProxyBase; 37struct TestPreferences; 38 39class WebTestDelegate { 40 public: 41 // Set and clear the edit command to execute on the next call to 42 // WebViewClient::handleCurrentKeyboardEvent(). 43 virtual void ClearEditCommand() = 0; 44 virtual void SetEditCommand(const std::string& name, 45 const std::string& value) = 0; 46 47 // Sets gamepad provider to be used for tests. 48 virtual void SetGamepadProvider( 49 scoped_ptr<RendererGamepadProvider> provider) = 0; 50 51 // Set data to return when registering via 52 // Platform::setDeviceLightListener(). 53 virtual void SetDeviceLightData(const double data) = 0; 54 // Set data to return when registering via 55 // Platform::setDeviceMotionListener(). 56 virtual void SetDeviceMotionData(const blink::WebDeviceMotionData& data) = 0; 57 // Set data to return when registering via 58 // Platform::setDeviceOrientationListener(). 59 virtual void SetDeviceOrientationData( 60 const blink::WebDeviceOrientationData& data) = 0; 61 62 // Set orientation to set when registering via 63 // Platform::setScreenOrientationListener(). 64 virtual void SetScreenOrientation( 65 const blink::WebScreenOrientationType& orientation) = 0; 66 67 // Reset the screen orientation data used for testing. 68 virtual void ResetScreenOrientation() = 0; 69 70 // Notifies blink about a change in battery status. 71 virtual void DidChangeBatteryStatus( 72 const blink::WebBatteryStatus& status) = 0; 73 74 // Add a message to the text dump for the layout test. 75 virtual void PrintMessage(const std::string& message) = 0; 76 77 // The delegate takes ownership of the WebTask objects and is responsible 78 // for deleting them. 79 virtual void PostTask(WebTask* task) = 0; 80 virtual void PostDelayedTask(WebTask* task, long long ms) = 0; 81 82 // Register a new isolated filesystem with the given files, and return the 83 // new filesystem id. 84 virtual blink::WebString RegisterIsolatedFileSystem( 85 const blink::WebVector<blink::WebString>& absolute_filenames) = 0; 86 87 // Gets the current time in milliseconds since the UNIX epoch. 88 virtual long long GetCurrentTimeInMillisecond() = 0; 89 90 // Convert the provided relative path into an absolute path. 91 virtual blink::WebString GetAbsoluteWebStringFromUTF8Path( 92 const std::string& path) = 0; 93 94 // Reads in the given file and returns its contents as data URL. 95 virtual blink::WebURL LocalFileToDataURL(const blink::WebURL& file_url) = 0; 96 97 // Replaces file:///tmp/LayoutTests/ with the actual path to the 98 // LayoutTests directory. 99 virtual blink::WebURL RewriteLayoutTestsURL(const std::string& utf8_url) = 0; 100 101 // Manages the settings to used for layout tests. 102 virtual TestPreferences* Preferences() = 0; 103 virtual void ApplyPreferences() = 0; 104 105 // Enables or disables synchronous resize mode. When enabled, all 106 // window-sizing machinery is 107 // short-circuited inside the renderer. This mode is necessary for some tests 108 // that were written 109 // before browsers had multi-process architecture and rely on window resizes 110 // to happen synchronously. 111 // The function has "unfortunate" it its name because we must strive to remove 112 // all tests 113 // that rely on this... well, unfortunate behavior. See 114 // http://crbug.com/309760 for the plan. 115 virtual void UseUnfortunateSynchronousResizeMode(bool enable) = 0; 116 117 // Controls auto resize mode. 118 virtual void EnableAutoResizeMode(const blink::WebSize& min_size, 119 const blink::WebSize& max_size) = 0; 120 virtual void DisableAutoResizeMode(const blink::WebSize& new_size) = 0; 121 122 // Clears DevTools' localStorage when an inspector test is started. 123 virtual void ClearDevToolsLocalStorage() = 0; 124 125 // Opens and closes the inspector. 126 virtual void ShowDevTools(const std::string& settings, 127 const std::string& frontend_url) = 0; 128 virtual void CloseDevTools() = 0; 129 130 // Evaluate the given script in the DevTools agent. 131 virtual void EvaluateInWebInspector(long call_id, 132 const std::string& script) = 0; 133 134 // Controls WebSQL databases. 135 virtual void ClearAllDatabases() = 0; 136 virtual void SetDatabaseQuota(int quota) = 0; 137 138 // Controls Web Notification permissions. 139 virtual blink::WebNotificationPresenter::Permission 140 CheckWebNotificationPermission(const GURL& origin) = 0; 141 virtual void GrantWebNotificationPermission(const GURL& origin, 142 bool permission_granted) = 0; 143 virtual void ClearWebNotificationPermissions() = 0; 144 145 // Controls the device scale factor of the main WebView for hidpi tests. 146 virtual void SetDeviceScaleFactor(float factor) = 0; 147 148 // Change the device color profile while running a layout test. 149 virtual void SetDeviceColorProfile(const std::string& name) = 0; 150 151 // Controls which WebView should be focused. 152 virtual void SetFocus(WebTestProxyBase* proxy, bool focus) = 0; 153 154 // Controls whether all cookies should be accepted or writing cookies in a 155 // third-party context is blocked. 156 virtual void SetAcceptAllCookies(bool accept) = 0; 157 158 // The same as RewriteLayoutTestsURL unless the resource is a path starting 159 // with /tmp/, then return a file URL to a temporary file. 160 virtual std::string PathToLocalResource(const std::string& resource) = 0; 161 162 // Sets the POSIX locale of the current process. 163 virtual void SetLocale(const std::string& locale) = 0; 164 165 // Invoked when the test finished. 166 virtual void TestFinished() = 0; 167 168 // Invoked when the embedder should close all but the main WebView. 169 virtual void CloseRemainingWindows() = 0; 170 171 virtual void DeleteAllCookies() = 0; 172 173 // Returns the length of the back/forward history of the main WebView. 174 virtual int NavigationEntryCount() = 0; 175 176 // The following trigger navigations on the main WebViwe. 177 virtual void GoToOffset(int offset) = 0; 178 virtual void Reload() = 0; 179 virtual void LoadURLForFrame(const blink::WebURL& url, 180 const std::string& frame_name) = 0; 181 182 // Returns true if resource requests to external URLs should be permitted. 183 virtual bool AllowExternalPages() = 0; 184 185 // Returns a text dump the back/forward history for the WebView associated 186 // with the given WebTestProxyBase. 187 virtual std::string DumpHistoryForWindow(WebTestProxyBase* proxy) = 0; 188}; 189 190} // namespace content 191 192#endif // CONTENT_SHELL_RENDERER_TEST_RUNNER_WEB_TEST_DELEGATE_H_ 193