[WK2] WTR needs an implementation of setAsynchronousSpellCheckingEnabled
[WebKit-https.git] / Tools / WebKitTestRunner / InjectedBundle / Bindings / TestRunner.idl
1 /*
2  * Copyright (C) 2010, 2011, 2012 Apple Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
14  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
15  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
17  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
18  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
19  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
20  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
21  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
22  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
23  * THE POSSIBILITY OF SUCH DAMAGE.
24  */
25
26 interface TestRunner {
27     // The basics.
28     void dumpAsText(in boolean dumpPixels);
29     void dumpChildFramesAsText();
30     void waitForPolicyDelegate();
31     void waitUntilDone();
32     void notifyDone();
33     double preciseTime();
34
35     // Other dumping.
36     void dumpBackForwardList();
37     void dumpChildFrameScrollPositions();
38     void dumpEditingCallbacks();
39     void dumpSelectionRect();
40     void dumpStatusCallbacks();
41     void dumpTitleChanges();
42     void dumpFullScreenCallbacks();
43     void dumpFrameLoadCallbacks();
44     void dumpProgressFinishedCallback();
45     void dumpResourceLoadCallbacks();
46     void dumpResourceResponseMIMETypes();
47     void dumpWillCacheResponse();
48     void dumpApplicationCacheDelegateCallbacks();
49     void dumpDatabaseCallbacks();
50
51     // Special options.
52     void keepWebHistory();
53     void setAcceptsEditing(in boolean value);
54     void setCanOpenWindows(in boolean value);
55     void setCloseRemainingWindowsWhenComplete(in boolean value);
56     void setXSSAuditorEnabled(in boolean value);
57     void setAllowUniversalAccessFromFileURLs(in boolean value);
58     void setAllowFileAccessFromFileURLs(in boolean value);
59     void setPluginsEnabled(in boolean value);
60     void setJavaScriptCanAccessClipboard(in boolean value);
61     void setPrivateBrowsingEnabled(in boolean value);
62     void setPopupBlockingEnabled(in boolean value);
63     void setAuthorAndUserStylesEnabled(in boolean value);
64     void setCustomPolicyDelegate(in boolean enabled, in boolean permissive);
65     void addOriginAccessWhitelistEntry(in DOMString sourceOrigin, in DOMString destinationProtocol, in DOMString destinationHost, in boolean allowDestinationSubdomains);
66     void removeOriginAccessWhitelistEntry(in DOMString sourceOrigin, in DOMString destinationProtocol, in DOMString destinationHost, in boolean allowDestinationSubdomains);
67     void setUserStyleSheetEnabled(in boolean value);
68     void setUserStyleSheetLocation(in DOMString location);
69     void setSpatialNavigationEnabled(in boolean value);
70     void setTabKeyCyclesThroughElements(in boolean enabled);
71     void setSerializeHTTPLoads();
72     void dispatchPendingLoadRequests();
73     void setCacheModel(in int model);
74     void setAsynchronousSpellCheckingEnabled(in boolean value);
75
76     // Special DOM functions.
77     void clearBackForwardList();
78     void execCommand(in DOMString name, in DOMString argument);
79     boolean isCommandEnabled(in DOMString name);
80     unsigned long windowCount();
81
82     // Special DOM variables.
83     attribute boolean globalFlag;
84
85     // Repaint testing.
86     void testRepaint();
87     void repaintSweepHorizontally();
88     void display();
89
90     // Printing
91     boolean isPageBoxVisible(in int pageIndex);
92
93     [PassContext] void setValueForUser(in object element, in DOMString value);
94
95     // UserContent testing.
96     void addUserScript(in DOMString source, in boolean runAtStart, in boolean allFrames);
97     void addUserStyleSheet(in DOMString source, in boolean allFrames);
98
99     // Local storage API
100     void clearAllDatabases();
101     void setDatabaseQuota(in unsigned long long quota);
102     DOMString pathToLocalResource(in DOMString url);
103
104     // Application Cache API
105     void clearAllApplicationCaches();
106     void setAppCacheMaximumSize(in unsigned long long size);
107     long long applicationCacheDiskUsageForOrigin(in DOMString origin);
108     void clearApplicationCacheForOrigin(in DOMString name);
109     void setApplicationCacheOriginQuota(in unsigned long long bytes);
110     void disallowIncreaseForApplicationCacheQuota();
111     object originsWithApplicationCache();
112
113     // Text search testing.
114     boolean findString(in DOMString target, in object optionsArray);
115
116     // Evaluating script in a special context.
117     [PassContext] void evaluateScriptInIsolatedWorld(in unsigned long worldID, in DOMString script);
118
119     // For Web Inspector tests
120     void showWebInspector();
121     void closeWebInspector();
122     void evaluateInWebInspector(in long callID, in DOMString script);
123
124     void setPOSIXLocale(in DOMString locale);
125
126     void setTextDirection(in DOMString direction);
127
128     void setWillSendRequestReturnsNull(in boolean flag);
129     void setWillSendRequestReturnsNullOnRedirect(in boolean flag);
130     
131     void setShouldStayOnPageAfterHandlingBeforeUnload(in boolean flag);
132
133     void setDefersLoading(in boolean flag);
134     void setStopProvisionalFrameLoads();
135
136     // Focus testing.
137     void addChromeInputField(in object callback);
138     void removeChromeInputField(in object callback);
139     void focusWebView(in object callback);
140
141     void setBackingScaleFactor(in double backingScaleFactor, in object callback);
142
143     void setWindowIsKey(in boolean isKey);
144
145     // Cookies testing
146     void setAlwaysAcceptCookies(in boolean accept);
147
148     void overridePreference(in DOMString preference, in DOMString value);
149
150     // Page Visibility API
151     void setPageVisibility(in DOMString state);
152     void resetPageVisibility();
153
154     readonly attribute DOMString platformName;
155
156     // Control full screen behavior.
157     void setHasCustomFullScreenBehavior(in boolean value);
158     void setViewModeMediaFeature(in DOMString mode);
159
160     // Web notifications support
161     void grantWebNotificationPermission(in DOMString origin);
162     void denyWebNotificationPermission(in DOMString origin);
163     void removeAllWebNotificationPermissions();
164     void simulateWebNotificationClick(in object notification);
165
166     // Geolocation
167     void setGeolocationPermission(in boolean value);
168     void setMockGeolocationPosition(in double latitude, in double longitude, in double accuracy, in [Optional=DefaultIsUndefined] object altitude, in [Optional] object altitudeAccuracy, in [Optional] object heading, in [Optional] object speed);
169     void setMockGeolocationPositionUnavailableError(in DOMString errorMessage);
170
171     // Audio testing.
172     [PassContext] void setAudioData(in object data);
173
174     boolean callShouldCloseOnWebView();
175
176     // Work queue.
177     void queueBackNavigation(in unsigned long howFarBackward);
178     void queueForwardNavigation(in unsigned long howFarForward);
179     void queueLoad(in DOMString url, in DOMString target);
180     void queueLoadHTMLString(in DOMString content, in [Optional] DOMString baseURL, in [Optional] DOMString unreachableURL);
181     void queueReload();
182     void queueLoadingScript(in DOMString script);
183     void queueNonLoadingScript(in DOMString script);
184
185     // Authentication
186     void setHandlesAuthenticationChallenges(in boolean value);
187     void setAuthenticationUsername(in DOMString username);
188     void setAuthenticationPassword(in DOMString password);
189 };
190