Index: Source/WebKit/chromium/public/WebFrameClient.h |
diff --git a/Source/WebKit/chromium/public/WebFrameClient.h b/Source/WebKit/chromium/public/WebFrameClient.h |
index 8eb9f2efc0f96c621918835620a2a31ab0061a80..41899025be2fdc2e58d771fb93208cb9a44dcba0 100644 |
--- a/Source/WebKit/chromium/public/WebFrameClient.h |
+++ b/Source/WebKit/chromium/public/WebFrameClient.h |
@@ -1,438 +1 @@ |
-/* |
- * Copyright (C) 2011, 2012 Google Inc. All rights reserved. |
- * |
- * Redistribution and use in source and binary forms, with or without |
- * modification, are permitted provided that the following conditions are |
- * met: |
- * |
- * * Redistributions of source code must retain the above copyright |
- * notice, this list of conditions and the following disclaimer. |
- * * Redistributions in binary form must reproduce the above |
- * copyright notice, this list of conditions and the following disclaimer |
- * in the documentation and/or other materials provided with the |
- * distribution. |
- * * Neither the name of Google Inc. nor the names of its |
- * contributors may be used to endorse or promote products derived from |
- * this software without specific prior written permission. |
- * |
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
- * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
- * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
- * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
- * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
- * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
- */ |
- |
-#ifndef WebFrameClient_h |
-#define WebFrameClient_h |
- |
-#include "../../../../public/platform/WebCommon.h" |
-#include "../../../../public/platform/WebFileSystem.h" |
-#include "../../../../public/platform/WebFileSystemType.h" |
-#include "../../../../public/platform/WebURLError.h" |
-#include "../../../../public/platform/WebURLRequest.h" |
-#include "WebDOMMessageEvent.h" |
-#include "WebIconURL.h" |
-#include "WebNavigationPolicy.h" |
-#include "WebNavigationType.h" |
-#include "WebSecurityOrigin.h" |
-#include "WebStorageQuotaType.h" |
-#include "WebTextDirection.h" |
-#include <v8.h> |
- |
-namespace WebKit { |
- |
-class WebApplicationCacheHost; |
-class WebApplicationCacheHostClient; |
-class WebCachedURLRequest; |
-class WebCookieJar; |
-class WebDataSource; |
-class WebDOMEvent; |
-class WebFormElement; |
-class WebFrame; |
-class WebMediaPlayer; |
-class WebMediaPlayerClient; |
-class WebNode; |
-class WebPlugin; |
-class WebRTCPeerConnectionHandler; |
-class WebSharedWorker; |
-class WebSharedWorkerClient; |
-class WebSocketStreamHandle; |
-class WebStorageQuotaCallbacks; |
-class WebString; |
-class WebURL; |
-class WebURLLoader; |
-class WebURLResponse; |
-class WebWorker; |
-struct WebPluginParams; |
-struct WebRect; |
-struct WebSize; |
-struct WebURLError; |
- |
-class WebFrameClient { |
-public: |
- // Factory methods ----------------------------------------------------- |
- |
- // May return null. |
- virtual WebPlugin* createPlugin(WebFrame*, const WebPluginParams&) { return 0; } |
- |
- // May return null. |
- virtual WebSharedWorker* createSharedWorker(WebFrame*, const WebURL&, const WebString&, unsigned long long) { return 0; } |
- |
- // May return null. |
- virtual WebMediaPlayer* createMediaPlayer(WebFrame*, const WebURL&, WebMediaPlayerClient*) { return 0; } |
- |
- // May return null. |
- virtual WebApplicationCacheHost* createApplicationCacheHost(WebFrame*, WebApplicationCacheHostClient*) { return 0; } |
- |
- |
- // Services ------------------------------------------------------------ |
- |
- // A frame specific cookie jar. May return null, in which case |
- // WebKitPlatformSupport::cookieJar() will be called to access cookies. |
- virtual WebCookieJar* cookieJar(WebFrame*) { return 0; } |
- |
- |
- // General notifications ----------------------------------------------- |
- |
- // Indicates that another page has accessed the DOM of the initial empty |
- // document of a main frame. After this, it is no longer safe to show a |
- // pending navigation's URL, because a URL spoof is possible. |
- virtual void didAccessInitialDocument(WebFrame*) { } |
- |
- // A child frame was created in this frame. This is called when the frame |
- // is created and initialized. |
- virtual void didCreateFrame(WebFrame* parent, WebFrame* child) { } |
- |
- // This frame set its opener to null, disowning it. |
- // See http://html.spec.whatwg.org/#dom-opener. |
- virtual void didDisownOpener(WebFrame*) { } |
- |
- // This frame has been detached from the view, but has not been closed yet. |
- virtual void frameDetached(WebFrame*) { } |
- |
- // This frame is about to be closed. This is called after frameDetached, |
- // when the document is being unloaded, due to new one committing. |
- virtual void willClose(WebFrame*) { } |
- |
- // This frame's name has changed. |
- virtual void didChangeName(WebFrame*, const WebString&) { } |
- |
- // Load commands ------------------------------------------------------- |
- |
- // The client should handle the navigation externally. |
- virtual void loadURLExternally( |
- WebFrame*, const WebURLRequest&, WebNavigationPolicy) { } |
- virtual void loadURLExternally( |
- WebFrame*, const WebURLRequest&, WebNavigationPolicy, const WebString& downloadName) { } |
- |
- |
- // Navigational queries ------------------------------------------------ |
- |
- // The client may choose to alter the navigation policy. Otherwise, |
- // defaultPolicy should just be returned. |
- virtual WebNavigationPolicy decidePolicyForNavigation( |
- WebFrame*, const WebURLRequest&, WebNavigationType, |
- WebNavigationPolicy defaultPolicy, bool isRedirect) { return defaultPolicy; } |
- |
- // Returns an error corresponding to canHandledRequest() returning false. |
- virtual WebURLError cannotHandleRequestError( |
- WebFrame*, const WebURLRequest& request) { return WebURLError(); } |
- |
- // Returns an error corresponding to a user cancellation event. |
- virtual WebURLError cancelledError( |
- WebFrame*, const WebURLRequest& request) { return WebURLError(); } |
- |
- // Notify that a URL cannot be handled. |
- virtual void unableToImplementPolicyWithError( |
- WebFrame*, const WebURLError&) { } |
- |
- |
- // Navigational notifications ------------------------------------------ |
- |
- // A form submission has been requested, but the page's submit event handler |
- // hasn't yet had a chance to run (and possibly alter/interrupt the submit.) |
- virtual void willSendSubmitEvent(WebFrame*, const WebFormElement&) { } |
- |
- // A form submission is about to occur. |
- virtual void willSubmitForm(WebFrame*, const WebFormElement&) { } |
- |
- // A client-side redirect will occur. This may correspond to a <META |
- // refresh> or some script activity. |
- virtual void willPerformClientRedirect( |
- WebFrame*, const WebURL& from, const WebURL& to, |
- double interval, double fireTime) { } |
- |
- // A client-side redirect was cancelled. |
- virtual void didCancelClientRedirect(WebFrame*) { } |
- |
- // A client-side redirect completed. |
- virtual void didCompleteClientRedirect(WebFrame*, const WebURL& fromURL) { } |
- |
- // A datasource has been created for a new navigation. The given |
- // datasource will become the provisional datasource for the frame. |
- virtual void didCreateDataSource(WebFrame*, WebDataSource*) { } |
- |
- // A new provisional load has been started. |
- virtual void didStartProvisionalLoad(WebFrame*) { } |
- |
- // The provisional load was redirected via a HTTP 3xx response. |
- virtual void didReceiveServerRedirectForProvisionalLoad(WebFrame*) { } |
- |
- // The provisional load failed. |
- virtual void didFailProvisionalLoad(WebFrame*, const WebURLError&) { } |
- |
- // Notifies the client to commit data for the given frame. The client |
- // may optionally prevent default processing by setting preventDefault |
- // to true before returning. If default processing is prevented, then |
- // it is up to the client to manually call commitDocumentData on the |
- // WebFrame. It is only valid to call commitDocumentData within a call |
- // to didReceiveDocumentData. If commitDocumentData is not called, |
- // then an empty document will be loaded. |
- virtual void didReceiveDocumentData( |
- WebFrame*, const char* data, size_t length, bool& preventDefault) { } |
- |
- // The provisional datasource is now committed. The first part of the |
- // response body has been received, and the encoding of the response |
- // body is known. |
- virtual void didCommitProvisionalLoad(WebFrame*, bool isNewNavigation) { } |
- |
- // The window object for the frame has been cleared of any extra |
- // properties that may have been set by script from the previously |
- // loaded document. |
- virtual void didClearWindowObject(WebFrame*) { } |
- |
- // The document element has been created. |
- virtual void didCreateDocumentElement(WebFrame*) { } |
- |
- // The page title is available. |
- virtual void didReceiveTitle(WebFrame* frame, const WebString& title, WebTextDirection direction) { } |
- |
- // The icon for the page have changed. |
- virtual void didChangeIcon(WebFrame*, WebIconURL::Type) { } |
- |
- // The frame's document finished loading. |
- virtual void didFinishDocumentLoad(WebFrame*) { } |
- |
- // The 'load' event was dispatched. |
- virtual void didHandleOnloadEvents(WebFrame*) { } |
- |
- // The frame's document or one of its subresources failed to load. |
- virtual void didFailLoad(WebFrame*, const WebURLError&) { } |
- |
- // The frame's document and all of its subresources succeeded to load. |
- virtual void didFinishLoad(WebFrame*) { } |
- |
- // The navigation resulted in no change to the documents within the page. |
- // For example, the navigation may have just resulted in scrolling to a |
- // named anchor or a PopState event may have been dispatched. |
- virtual void didNavigateWithinPage(WebFrame*, bool isNewNavigation) { } |
- |
- // The navigation resulted in scrolling the page to a named anchor instead |
- // of downloading a new document. |
- virtual void didChangeLocationWithinPage(WebFrame*) { } |
- |
- // Called upon update to scroll position, document state, and other |
- // non-navigational events related to the data held by WebHistoryItem. |
- // WARNING: This method may be called very frequently. |
- virtual void didUpdateCurrentHistoryItem(WebFrame*) { } |
- |
- |
- // Low-level resource notifications ------------------------------------ |
- |
- // An element will request a resource. |
- virtual void willRequestResource(WebFrame*, const WebCachedURLRequest&) { } |
- |
- // A request is about to be sent out, and the client may modify it. Request |
- // is writable, and changes to the URL, for example, will change the request |
- // made. If this request is the result of a redirect, then redirectResponse |
- // will be non-null and contain the response that triggered the redirect. |
- virtual void willSendRequest( |
- WebFrame*, unsigned identifier, WebURLRequest&, |
- const WebURLResponse& redirectResponse) { } |
- |
- // Response headers have been received for the resource request given |
- // by identifier. |
- virtual void didReceiveResponse( |
- WebFrame*, unsigned identifier, const WebURLResponse&) { } |
- |
- virtual void didChangeResourcePriority( |
- WebFrame*, unsigned identifier, const WebKit::WebURLRequest::Priority&) { } |
- |
- // The resource request given by identifier succeeded. |
- virtual void didFinishResourceLoad( |
- WebFrame*, unsigned identifier) { } |
- |
- // The resource request given by identifier failed. |
- virtual void didFailResourceLoad( |
- WebFrame*, unsigned identifier, const WebURLError&) { } |
- |
- // The specified request was satified from WebCore's memory cache. |
- virtual void didLoadResourceFromMemoryCache( |
- WebFrame*, const WebURLRequest&, const WebURLResponse&) { } |
- |
- // This frame has displayed inactive content (such as an image) from an |
- // insecure source. Inactive content cannot spread to other frames. |
- virtual void didDisplayInsecureContent(WebFrame*) { } |
- |
- // The indicated security origin has run active content (such as a |
- // script) from an insecure source. Note that the insecure content can |
- // spread to other frames in the same origin. |
- virtual void didRunInsecureContent(WebFrame*, const WebSecurityOrigin&, const WebURL& insecureURL) { } |
- |
- // A reflected XSS was encountered in the page and suppressed. |
- virtual void didDetectXSS(WebFrame*, const WebURL&, bool didBlockEntirePage) { } |
- |
- // Script notifications ------------------------------------------------ |
- |
- // Script in the page tried to allocate too much memory. |
- virtual void didExhaustMemoryAvailableForScript(WebFrame*) { } |
- |
- // Notifies that a new script context has been created for this frame. |
- // This is similar to didClearWindowObject but only called once per |
- // frame context. |
- virtual void didCreateScriptContext(WebFrame*, v8::Handle<v8::Context>, int extensionGroup, int worldId) { } |
- |
- // WebKit is about to release its reference to a v8 context for a frame. |
- virtual void willReleaseScriptContext(WebFrame*, v8::Handle<v8::Context>, int worldId) { } |
- |
- // Geometry notifications ---------------------------------------------- |
- |
- // The frame's document finished the initial layout of a page. |
- virtual void didFirstLayout(WebFrame*) { } |
- |
- // The frame's document finished the initial non-empty layout of a page. |
- virtual void didFirstVisuallyNonEmptyLayout(WebFrame*) { } |
- |
- // The size of the content area changed. |
- virtual void didChangeContentsSize(WebFrame*, const WebSize&) { } |
- |
- // The main frame scrolled. |
- virtual void didChangeScrollOffset(WebFrame*) { } |
- |
- // If the frame is loading an HTML document, this will be called to |
- // notify that the <body> will be attached soon. |
- virtual void willInsertBody(WebFrame*) { } |
- |
- // Find-in-page notifications ------------------------------------------ |
- |
- // Notifies how many matches have been found so far, for a given |
- // identifier. |finalUpdate| specifies whether this is the last update |
- // (all frames have completed scoping). |
- virtual void reportFindInPageMatchCount( |
- int identifier, int count, bool finalUpdate) { } |
- |
- // Notifies what tick-mark rect is currently selected. The given |
- // identifier lets the client know which request this message belongs |
- // to, so that it can choose to ignore the message if it has moved on |
- // to other things. The selection rect is expected to have coordinates |
- // relative to the top left corner of the web page area and represent |
- // where on the screen the selection rect is currently located. |
- virtual void reportFindInPageSelection( |
- int identifier, int activeMatchOrdinal, const WebRect& selection) { } |
- |
- // FileSystem ---------------------------------------------------- |
- |
- // Requests to open a FileSystem. |
- // |size| indicates how much storage space (in bytes) the caller expects |
- // to need. |
- // WebFileSystemCallbacks::didOpenFileSystem() must be called with |
- // a name and root path for the requested FileSystem when the operation |
- // is completed successfully. WebFileSystemCallbacks::didFail() must be |
- // called otherwise. The create bool is for indicating whether or not to |
- // create root path for file systems if it do not exist. |
- virtual void openFileSystem( |
- WebFrame*, WebFileSystemType, long long size, |
- bool create, WebFileSystemCallbacks*) { } |
- |
- // Deletes FileSystem. |
- // WebFileSystemCallbacks::didSucceed() must be called when the operation |
- // is completed successfully. WebFileSystemCallbacks::didFail() must be |
- // called otherwise. |
- // All in-flight operations and following operations may fail after the |
- // FileSystem is deleted. |
- virtual void deleteFileSystem( |
- WebFrame*, WebFileSystemType, WebFileSystemCallbacks*) { } |
- |
- // Quota --------------------------------------------------------- |
- |
- // Queries the origin's storage usage and quota information. |
- // WebStorageQuotaCallbacks::didQueryStorageUsageAndQuota will be called |
- // with the current usage and quota information for the origin. When |
- // an error occurs WebStorageQuotaCallbacks::didFail is called with an |
- // error code. |
- // The callbacks object is deleted when the callback method is called |
- // and does not need to be (and should not be) deleted manually. |
- virtual void queryStorageUsageAndQuota( |
- WebFrame*, WebStorageQuotaType, WebStorageQuotaCallbacks*) { } |
- |
- // Requests a new quota size for the origin's storage. |
- // |newQuotaInBytes| indicates how much storage space (in bytes) the |
- // caller expects to need. |
- // WebStorageQuotaCallbacks::didGrantStorageQuota will be called when |
- // a new quota is granted. WebStorageQuotaCallbacks::didFail |
- // is called with an error code otherwise. |
- // Note that the requesting quota size may not always be granted and |
- // a smaller amount of quota than requested might be returned. |
- // The callbacks object is deleted when the callback method is called |
- // and does not need to be (and should not be) deleted manually. |
- virtual void requestStorageQuota( |
- WebFrame*, WebStorageQuotaType, |
- unsigned long long newQuotaInBytes, |
- WebStorageQuotaCallbacks*) { } |
- |
- // WebSocket ----------------------------------------------------- |
- |
- // A WebSocket object is going to open new stream connection. |
- virtual void willOpenSocketStream(WebSocketStreamHandle*) { } |
- |
- // MediaStream ----------------------------------------------------- |
- |
- // A new WebRTCPeerConnectionHandler is created. |
- virtual void willStartUsingPeerConnectionHandler(WebFrame*, WebRTCPeerConnectionHandler*) { } |
- |
- // Messages ------------------------------------------------------ |
- |
- // Notifies the embedder that a postMessage was issued on this frame, and |
- // gives the embedder a chance to handle it instead of WebKit. Returns true |
- // if the embedder handled it. |
- virtual bool willCheckAndDispatchMessageEvent( |
- WebFrame* sourceFrame, |
- WebFrame* targetFrame, |
- WebSecurityOrigin target, |
- WebDOMMessageEvent event) { return false; } |
- |
- // Asks the embedder if a specific user agent should be used for the given |
- // URL. Non-empty strings indicate an override should be used. Otherwise, |
- // Platform::current()->userAgent() will be called to provide one. |
- virtual WebString userAgentOverride(WebFrame*, const WebURL& url) { return WebString(); } |
- |
- // Asks the embedder what value the network stack will send for the DNT |
- // header. An empty string indicates that no DNT header will be send. |
- virtual WebString doNotTrackValue(WebFrame*) { return WebString(); } |
- |
- // WebGL ------------------------------------------------------ |
- |
- // Asks the embedder whether WebGL is allowed for the given WebFrame. |
- // This call is placed here instead of WebPermissionClient because this |
- // class is implemented in content/, and putting it here avoids adding |
- // more public content/ APIs. |
- virtual bool allowWebGL(WebFrame*, bool defaultValue) { return defaultValue; } |
- |
- // Notifies the client that a WebGL context was lost on this page with the |
- // given reason (one of the GL_ARB_robustness status codes; see |
- // Extensions3D.h in WebCore/platform/graphics). |
- virtual void didLoseWebGLContext(WebFrame*, int) { } |
- |
-protected: |
- ~WebFrameClient() { } |
-}; |
- |
-} // namespace WebKit |
- |
-#endif |
+#include "../../../../public/webview/WebFrameClient.h" |