Introduce SubframeNavigationFilteringThrottle

content/public/browser/navigation_handle.h

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CONTENT_PUBLIC_BROWSER_NAVIGATION_HANDLE_H_
 #define CONTENT_PUBLIC_BROWSER_NAVIGATION_HANDLE_H_
 
 #include <memory>
 #include <string>
 
@@ skipping 21 matching lines @@
 class WebContents;
 
 // A NavigationHandle tracks information related to a single navigation.
 // NavigationHandles are provided to several WebContentsObserver methods to
 // allow observers to track specific navigations. Observers should clear any
 // references to a NavigationHandle at the time of
 // WebContentsObserver::DidFinishNavigation, just before the handle is
 // destroyed.
 class CONTENT_EXPORT NavigationHandle {
  public:
+  typedef base::Callback<void(NavigationThrottle::ThrottleCheckResult)>
+      ThrottleChecksFinishedCallback;
+
   virtual ~NavigationHandle() {}
 
   // Parameters available at navigation start time -----------------------------
   //
   // These parameters are always available during the navigation. Note that
   // some may change during navigation (e.g. due to server redirects).
 
   // The URL the frame is navigating to. This may change during the navigation
   // when encountering a server redirect.
   // This URL may not be the same as the virtual URL returned from
@@ skipping 191 matching lines @@
   // Registers a NavigationThrottle for tests. The throttle can
   // modify the request, pause the request or cancel the request. This will
   // take ownership of the NavigationThrottle.
   // Note: in non-test cases, NavigationThrottles should not be added directly
   // but returned by the implementation of
   // ContentBrowserClient::CreateThrottlesForNavigation. This ensures proper
   // ordering of the throttles.
   virtual void RegisterThrottleForTesting(
       std::unique_ptr<NavigationThrottle> navigation_throttle) = 0;
 
+  //  The Call*ForTesting methods return the synchronous throttle check result
+  //  and DEFER if the checks are completing asynchronously. To observe async
+  //  checks, use the optionally null |complete_callback|, which will be called
+  //  whenever the checks are completely finished.
+
   // Simulates the network request starting.
   virtual NavigationThrottle::ThrottleCheckResult
-  CallWillStartRequestForTesting(bool is_post,
-                                 const Referrer& sanitized_referrer,
-                                 bool has_user_gesture,
-                                 ui::PageTransition transition,
-                                 bool is_external_protocol) = 0;
+  CallWillStartRequestForTesting(
+      bool is_post,
+      const Referrer& sanitized_referrer,
+      bool has_user_gesture,
+      ui::PageTransition transition,
+      bool is_external_protocol,
+      const ThrottleChecksFinishedCallback& complete_callback) = 0;
 
   // Simulates the network request being redirected.
   virtual NavigationThrottle::ThrottleCheckResult
-  CallWillRedirectRequestForTesting(const GURL& new_url,
-                                    bool new_method_is_post,
-                                    const GURL& new_referrer_url,
-                                    bool new_is_external_protocol) = 0;
+  CallWillRedirectRequestForTesting(
+      const GURL& new_url,
+      bool new_method_is_post,
+      const GURL& new_referrer_url,
+      bool new_is_external_protocol,
+      const ThrottleChecksFinishedCallback& complete_callback) = 0;
 
   // Simulates the reception of the network response.
   virtual NavigationThrottle::ThrottleCheckResult
   CallWillProcessResponseForTesting(
       RenderFrameHost* render_frame_host,
-      const std::string& raw_response_headers) = 0;
+      const std::string& raw_response_headers,
+      const ThrottleChecksFinishedCallback& complete_callback) = 0;
 
   // Simulates the navigation being committed.
   virtual void CallDidCommitNavigationForTesting(const GURL& url) = 0;
 
   // The NavigationData that the embedder returned from
   // ResourceDispatcherHostDelegate::GetNavigationData during commit. This will
   // be a clone of the NavigationData.
   virtual NavigationData* GetNavigationData() = 0;
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_NAVIGATION_HANDLE_H_