navigator_delegate.h revision 5f1c94371a64b3196d4be9466099bb892df9b88e 
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_BROWSER_FRAME_HOST_NAVIGATOR_DELEGATE_H_
6#define CONTENT_BROWSER_FRAME_HOST_NAVIGATOR_DELEGATE_H_
7
8#include "base/strings/string16.h"
9#include "content/public/browser/invalidate_type.h"
10#include "content/public/browser/navigation_controller.h"
11#include "content/public/common/page_transition_types.h"
12#include "ui/base/window_open_disposition.h"
13
14class GURL;
15struct FrameHostMsg_DidCommitProvisionalLoad_Params;
16struct FrameHostMsg_DidFailProvisionalLoadWithError_Params;
17
18namespace content {
19
20class RenderFrameHostImpl;
21struct LoadCommittedDetails;
22struct OpenURLParams;
23
24// A delegate API used by Navigator to notify its embedder of navigation
25// related events.
26class CONTENT_EXPORT NavigatorDelegate {
27 public:
28  // The RenderFrameHost started a provisional load for the frame
29  // represented by |render_frame_host|.
30  virtual void DidStartProvisionalLoad(
31      RenderFrameHostImpl* render_frame_host,
32      const GURL& validated_url,
33      bool is_error_page,
34      bool is_iframe_srcdoc) {}
35
36  // The |render_frame_host| started a transition-flagged navigation.
37  virtual void DidStartNavigationTransition(
38      RenderFrameHostImpl* render_frame_host) {}
39
40  // A provisional load in |render_frame_host| failed.
41  virtual void DidFailProvisionalLoadWithError(
42      RenderFrameHostImpl* render_frame_host,
43      const FrameHostMsg_DidFailProvisionalLoadWithError_Params& params) {}
44
45  // Document load in |render_frame_host| failed.
46  virtual void DidFailLoadWithError(
47      RenderFrameHostImpl* render_frame_host,
48      const GURL& url,
49      int error_code,
50      const base::string16& error_description) {}
51
52  // A redirect was processed in |render_frame_host| during a provisional load.
53  virtual void DidRedirectProvisionalLoad(
54      RenderFrameHostImpl* render_frame_host,
55      const GURL& validated_target_url) {}
56
57  // A navigation was committed in |render_frame_host|.
58  virtual void DidCommitProvisionalLoad(
59      RenderFrameHostImpl* render_frame_host,
60      const GURL& url,
61      PageTransition transition_type) {}
62
63  // Handles post-navigation tasks in navigation BEFORE the entry has been
64  // committed to the NavigationController.
65  virtual void DidNavigateMainFramePreCommit(bool navigation_is_within_page) {}
66
67  // Handles post-navigation tasks in navigation AFTER the entry has been
68  // committed to the NavigationController. Note that the NavigationEntry is
69  // not provided since it may be invalid/changed after being committed. The
70  // NavigationController's last committed entry is for this navigation.
71  virtual void DidNavigateMainFramePostCommit(
72      const LoadCommittedDetails& details,
73      const FrameHostMsg_DidCommitProvisionalLoad_Params& params) {}
74  virtual void DidNavigateAnyFramePostCommit(
75      RenderFrameHostImpl* render_frame_host,
76      const LoadCommittedDetails& details,
77      const FrameHostMsg_DidCommitProvisionalLoad_Params& params) {}
78
79  virtual void SetMainFrameMimeType(const std::string& mime_type) {}
80  virtual bool CanOverscrollContent() const;
81
82  // Notification to the Navigator embedder that navigation state has
83  // changed. This method corresponds to
84  // WebContents::NotifyNavigationStateChanged.
85  virtual void NotifyChangedNavigationState(InvalidateTypes changed_flags) {}
86
87  // Notifies the Navigator embedder that it is beginning to navigate a frame.
88  virtual void AboutToNavigateRenderFrame(
89      RenderFrameHostImpl* render_frame_host) {}
90
91  // Notifies the Navigator embedder that a navigation to pending
92  // NavigationEntry has started in the browser process.
93  virtual void DidStartNavigationToPendingEntry(
94      RenderFrameHostImpl* render_frame_host,
95      const GURL& url,
96      NavigationController::ReloadType reload_type) {}
97
98  // Opens a URL with the given parameters. See PageNavigator::OpenURL, which
99  // this forwards to.
100  virtual void RequestOpenURL(RenderFrameHostImpl* render_frame_host,
101                              const OpenURLParams& params) {}
102
103  // Returns whether URLs for aborted browser-initiated navigations should be
104  // preserved in the omnibox.  Defaults to false.
105  virtual bool ShouldPreserveAbortedURLs();
106};
107
108}  // namspace content
109
110#endif  // CONTENT_BROWSER_FRAME_HOST_NAVIGATOR_DELEGATE_H_
111