| Index: public/webpage/WebFrameClient.h
|
| diff --git a/public/webpage/WebFrameClient.h b/public/webpage/WebFrameClient.h
|
| deleted file mode 100644
|
| index 53607d9d3ed447969bfa601550310031e36f2461..0000000000000000000000000000000000000000
|
| --- a/public/webpage/WebFrameClient.h
|
| +++ /dev/null
|
| @@ -1,438 +0,0 @@
|
| -/*
|
| - * 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 "../platform/WebCommon.h"
|
| -#include "../platform/WebFileSystem.h"
|
| -#include "../platform/WebFileSystemType.h"
|
| -#include "../platform/WebURLError.h"
|
| -#include "../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
|
|
|