#include "base/process/process_handle.h"
#include "content/common/content_export.h"
#include "content/public/browser/navigation_controller.h"
+#include "content/public/common/frame_navigate_params.h"
#include "content/public/common/page_transition_types.h"
#include "ipc/ipc_listener.h"
#include "ipc/ipc_sender.h"
namespace content {
class NavigationEntry;
+class RenderFrameHost;
class RenderViewHost;
class WebContents;
class WebContentsImpl;
+struct AXEventNotificationDetails;
struct FaviconURL;
struct FrameNavigateParams;
struct LoadCommittedDetails;
class CONTENT_EXPORT WebContentsObserver : public IPC::Listener,
public IPC::Sender {
public:
- // Only one of the two methods below will be called when a RVH is created for
- // a WebContents, depending on whether it's for an interstitial or not.
+ // Called when a RenderFrameHost associated with this WebContents is created.
+ virtual void RenderFrameCreated(RenderFrameHost* render_frame_host) {}
+
+ // Called whenever a RenderFrameHost associated with this WebContents is
+ // deleted.
+ virtual void RenderFrameDeleted(RenderFrameHost* render_frame_host) {}
+
+ // This is called when a RVH is created for a WebContents, but not if it's an
+ // interstitial.
virtual void RenderViewCreated(RenderViewHost* render_view_host) {}
- virtual void RenderViewForInterstitialPageCreated(
- RenderViewHost* render_view_host) {}
+
+ // Called for every RenderFrameHost that's created for an interstitial.
+ virtual void RenderFrameForInterstitialPageCreated(
+ RenderFrameHost* render_frame_host) {}
// This method is invoked when the RenderView of the current RenderViewHost
// is ready, e.g. because we recreated it after a crash.
// This method is invoked when the process for the current RenderView crashes.
// The WebContents continues to use the RenderViewHost, e.g. when the user
- // reloads the current page.
- // When the RenderViewHost is deleted, the RenderViewDeleted method will be
- // invoked.
+ // reloads the current page. When the RenderViewHost itself is deleted, the
+ // RenderViewDeleted method will be invoked.
+ //
+ // Note that this is equivalent to
+ // RenderProcessHostObserver::RenderProcessExited().
virtual void RenderProcessGone(base::TerminationStatus status) {}
// This method is invoked when a WebContents swaps its render view host with
virtual void AboutToNavigateRenderView(
RenderViewHost* render_view_host) {}
- // This method is invoked right after the navigation was initiated.
- virtual void NavigateToPendingEntry(
+ // This method is invoked after the browser process starts a navigation to a
+ // pending NavigationEntry. It is not called for renderer-initiated
+ // navigations unless they are sent to the browser process via OpenURL. It may
+ // be called multiple times for a given navigation, such as a typed URL
+ // followed by a cross-process client or server redirect.
+ virtual void DidStartNavigationToPendingEntry(
const GURL& url,
NavigationController::ReloadType reload_type) {}
// WebContentsObserver::DidGetRedirectForResourceRequest instead.
virtual void ProvisionalChangeToMainFrameUrl(
const GURL& url,
- RenderViewHost* render_view_host) {}
+ RenderFrameHost* render_frame_host) {}
// This method is invoked when the provisional load was successfully
// committed. The |render_view_host| is now the current RenderViewHost of the
// this signal without a prior DidStartProvisionalLoadForFrame signal.
virtual void DidCommitProvisionalLoadForFrame(
int64 frame_id,
- const string16& frame_unique_name,
+ const base::string16& frame_unique_name,
bool is_main_frame,
const GURL& url,
PageTransition transition_type,
// This method is invoked when the provisional load failed.
virtual void DidFailProvisionalLoad(int64 frame_id,
- const string16& frame_unique_name,
+ const base::string16& frame_unique_name,
bool is_main_frame,
const GURL& validated_url,
int error_code,
- const string16& error_description,
+ const base::string16& error_description,
RenderViewHost* render_view_host) {}
// If the provisional load corresponded to the main frame, this method is
// This method is invoked once the onload handler of the main frame has
// completed.
- virtual void DocumentOnLoadCompletedInMainFrame(int32 page_id) {}
+ virtual void DocumentOnLoadCompletedInMainFrame() {}
// This method is invoked when the document in the given frame finished
// loading. At this point, scripts marked as defer were executed, and
const GURL& validated_url,
bool is_main_frame,
int error_code,
- const string16& error_description,
+ const base::string16& error_description,
RenderViewHost* render_view_host) {}
// This method is invoked when content was loaded from an in-memory cache.
// This method is invoked when a redirect was received while requesting a
// resource.
virtual void DidGetRedirectForResourceRequest(
+ RenderViewHost* render_view_host,
const ResourceRedirectDetails& details) {}
// This method is invoked when a new non-pending navigation entry is created.
virtual void FrameDetached(RenderViewHost* render_view_host,
int64 frame_id) {}
+ // This method is invoked when the renderer has completed its first paint
+ // after a non-empty layout.
+ virtual void DidFirstVisuallyNonEmptyPaint() {}
+
// These two methods correspond to the points in time when the spinner of the
// tab starts and stops spinning.
virtual void DidStartLoading(RenderViewHost* render_view_host) {}
WebContents* new_web_contents) {}
// Invoked when the WebContents is being destroyed. Gives subclasses a chance
- // to cleanup. At the time this is invoked |web_contents()| returns NULL.
- // It is safe to delete 'this' from here.
- virtual void WebContentsDestroyed(WebContents* web_contents) {}
+ // to cleanup. After the whole loop over all WebContentsObservers has been
+ // finished, web_contents() returns NULL.
+ virtual void WebContentsDestroyed() {}
// Called when the user agent override for a WebContents has been changed.
virtual void UserAgentOverrideSet(const std::string& user_agent) {}
// Invoked when new FaviconURL candidates are received from the renderer.
- virtual void DidUpdateFaviconURL(int32 page_id,
- const std::vector<FaviconURL>& candidates) {}
+ virtual void DidUpdateFaviconURL(const std::vector<FaviconURL>& candidates) {}
// Invoked when a pepper plugin creates and shows or destroys a fullscreen
// render widget.
virtual void DidShowFullscreenWidget(int routing_id) {}
virtual void DidDestroyFullscreenWidget(int routing_id) {}
+ // Invoked when the renderer has toggled the tab into/out of fullscreen mode.
+ virtual void DidToggleFullscreenModeForTab(bool entered_fullscreen) {}
+
// Invoked when visible SSL state (as defined by SSLStatus) changes.
virtual void DidChangeVisibleSSLState() {}
// Invoked when a user cancels a before unload dialog.
virtual void BeforeUnloadDialogCancelled() {}
+ // Invoked when an accessibility event is received from the renderer.
+ virtual void AccessibilityEventReceived(
+ const std::vector<AXEventNotificationDetails>& details) {}
+
// IPC::Listener implementation.
virtual bool OnMessageReceived(const IPC::Message& message) OVERRIDE;
private:
friend class WebContentsImpl;
- // Invoked from WebContentsImpl. Invokes WebContentsDestroyed and NULL out
- // |web_contents_|.
- void WebContentsImplDestroyed();
+ void ResetWebContents();
WebContentsImpl* web_contents_;
projects / platform / framework / web / crosswalk.git / blobdiff