Add a NavigationThrottle to the public content/ interface

content/public/browser/content_browser_client.h

 // Copyright (c) 2012 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_CONTENT_BROWSER_CLIENT_H_
 #define CONTENT_PUBLIC_BROWSER_CONTENT_BROWSER_CLIENT_H_
 
 #include <map>
 #include <string>
 #include <utility>
 #include <vector>
 
 #include "base/callback_forward.h"
 #include "base/memory/linked_ptr.h"
 #include "base/memory/scoped_ptr.h"
 #include "base/memory/scoped_vector.h"
 #include "base/values.h"
 #include "content/public/browser/certificate_request_result_type.h"
+#include "content/public/browser/navigation_throttle.h"
 #include "content/public/common/content_client.h"
 #include "content/public/common/media_stream_request.h"
 #include "content/public/common/resource_type.h"
 #include "content/public/common/socket_permission_request.h"
 #include "content/public/common/window_container_type.h"
 #include "net/base/mime_util.h"
 #include "net/cookies/canonical_cookie.h"
 #include "net/url_request/url_request_interceptor.h"
 #include "net/url_request/url_request_job_factory.h"
 #include "storage/browser/fileapi/file_system_context.h"
@@ skipping 62 matching lines @@
 class BrowserPluginGuestDelegate;
 class BrowserPpapiHost;
 class BrowserURLHandler;
 class ClientCertificateDelegate;
 class DevToolsManagerDelegate;
 class ExternalVideoSurfaceContainer;
 class LocationProvider;
 class MediaObserver;
 class NavigatorConnectContext;
 class NavigatorConnectServiceFactory;
+class NavigationHandle;

[Charlie Reis, 2015/09/11 00:06:48]

nit: Alphabetize.

[clamy, 2015/09/16 01:03:21]

Done.

 class PlatformNotificationService;
 class PresentationServiceDelegate;
 class QuotaPermissionContext;
 class RenderFrameHost;
 class RenderProcessHost;
 class RenderViewHost;
 class ResourceContext;
 class ServiceRegistry;
 class SiteInstance;
 class SpeechRecognitionManagerDelegate;
@@ skipping 549 matching lines @@
   // Allows programmatic opening of a new tab/window without going through
   // another WebContents. For example, from a Worker. |callback| will be
   // invoked with the appropriate WebContents* when available.
   virtual void OpenURL(BrowserContext* browser_context,
                        const OpenURLParams& params,
                        const base::Callback<void(WebContents*)>& callback);
 
   // Allows the embedder to record |metric| for a specific |url|.
   virtual void RecordURLMetric(const std::string& metric, const GURL& url) {}
 
+  // Allows the embedder to register one or more NavigationThrottles for a
+  // navigation. A NavigationThrottle is used to control the flow of a

[Charlie Reis, 2015/09/11 00:06:48]

nit: for the navigation indicated by |navigation_handle|.

[clamy, 2015/09/16 01:03:21]

Done.

+  // navigation on the UI thread. The embedder is guaranteed that the throttles
+  // will be executed in the order they were provided.
+  virtual ScopedVector<NavigationThrottle> GetNavigationThrottles(

[Charlie Reis, 2015/09/11 00:06:48]

"GetNavigationThrottles" sounds like an accessor for general purpose use.  Maybe
CreateThrottlesForNavigation?

[clamy, 2015/09/16 01:03:21]

Done.

+      NavigationHandle* navigation_handle);
+
   // Populates |mappings| with all files that need to be mapped before launching
   // a child process.
 #if defined(OS_ANDROID)
   virtual void GetAdditionalMappedFilesForChildProcess(
       const base::CommandLine& command_line,
       int child_process_id,
       content::FileDescriptorInfo* mappings,
       std::map<int, base::MemoryMappedFile::Region>* regions) {}
 #elif defined(OS_POSIX) && !defined(OS_MACOSX)
   virtual void GetAdditionalMappedFilesForChildProcess(
@@ skipping 23 matching lines @@
   // Allows an embedder to provide its own ExternalVideoSurfaceContainer
   // implementation.  Return nullptr to disable external surface video.
   virtual ExternalVideoSurfaceContainer*
   OverrideCreateExternalVideoSurfaceContainer(WebContents* web_contents);
 #endif
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_CONTENT_BROWSER_CLIENT_H_