Speculatively launch Service Workers on mouse/touch events. [3/5]

content/public/browser/service_worker_context.h

 // Copyright 2014 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_SERVICE_WORKER_CONTEXT_H_
 #define CONTENT_PUBLIC_BROWSER_SERVICE_WORKER_CONTEXT_H_
 
 #include <set>
 #include <string>
 
 #include "base/callback_forward.h"
 #include "content/public/browser/service_worker_usage_info.h"
 #include "url/gurl.h"
 
+namespace blink {
+enum class WebNavigationHintType;
+}
+
 namespace content {
 
 // Represents the per-StoragePartition ServiceWorker data.
 class ServiceWorkerContext {
  public:
   // https://rawgithub.com/slightlyoff/ServiceWorker/master/spec/service_worker/index.html#url-scope:
   // roughly, must be of the form "<origin>/<path>/*".
   typedef GURL Scope;
 
   typedef base::Callback<void(bool success)> ResultCallback;
@@ skipping 73 matching lines @@
   virtual void StopAllServiceWorkersForOrigin(const GURL& origin) = 0;
 
   // Stops all running service workers and unregisters all service worker
   // registrations. This method is used in LayoutTests to make sure that the
   // existing service worker will not affect the succeeding tests.
   //
   // This function can be called from any thread, but the callback will always
   // be called on the UI thread.
   virtual void ClearAllServiceWorkersForTest(const base::Closure& callback) = 0;
 
+  // Starts a Service Worker for |document_url| for a navigation hint in the
+  // specified render process |render_process_id|. Must be called from the UI
+  // thread. The |callback| will always be called on the UI thred.

[nhiroki, 2016/07/25 06:15:13]

s/UI thred/UI thread/

[horo, 2016/07/25 08:24:27]

Done.

+  // This method can fail if:
+  //  * No Service Worker was registered for |document_url|.
+  //  * The specified render process is suitable for loading |document_url|.

[nhiroki, 2016/07/25 06:15:13]

is suitable -> is not suitable ?

[horo, 2016/07/25 08:24:27]

Done.

+  //    This check is done by RenderProcessHostImpl::IsSuitableHost().

[nhiroki, 2016/07/25 06:15:13]

RenderProcessHostImpl::IsSuitableHost() is an implementation detail and it might
not be necessary to mention in a public interface.

[horo, 2016/07/25 08:24:27]

Done.

+  //  * Something unexpected goes wrong, like a renderer crash.

[nhiroki, 2016/07/25 06:15:13]

This would be obvious and not necessary.

[horo, 2016/07/25 08:24:27]

Done.

+  virtual void StartServiceWorkerForNavigationHint(
+      const GURL& document_url,
+      blink::WebNavigationHintType type,
+      int render_process_id,
+      const ResultCallback& callback) = 0;
+
  protected:
   ServiceWorkerContext() {}
   virtual ~ServiceWorkerContext() {}
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_SERVICE_WORKER_CONTEXT_H_