1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
// 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/basictypes.h"
#include "base/callback_forward.h"
#include "content/public/browser/service_worker_usage_info.h"
#include "net/base/completion_callback.h"
#include "url/gurl.h"
namespace net {
class URLRequest;
}
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;
typedef base::Callback<void(const std::vector<ServiceWorkerUsageInfo>&
usage_info)> GetUsageInfoCallback;
// Registers the header name which should not be passed to the ServiceWorker.
// Must be called from the IO thread.
CONTENT_EXPORT static void AddExcludedHeadersForFetchEvent(
const std::set<std::string>& header_names);
// Returns true if the header name should not be passed to the ServiceWorker.
// Must be called from the IO thread.
static bool IsExcludedHeaderNameForFetchEvent(const std::string& header_name);
// Retrieves the ServiceWorkerContext, if any, associated with |request|.
CONTENT_EXPORT static ServiceWorkerContext* GetServiceWorkerContext(
net::URLRequest* request);
// Equivalent to calling navigator.serviceWorker.register(script_url, {scope:
// pattern}) from a renderer, except that |pattern| is an absolute URL instead
// of relative to some current origin. |callback| is passed true when the JS
// promise is fulfilled or false when the JS promise is rejected.
//
// The registration can fail if:
// * |script_url| is on a different origin from |pattern|
// * Fetching |script_url| fails.
// * |script_url| fails to parse or its top-level execution fails.
// TODO: The error message for this needs to be available to developers.
// * Something unexpected goes wrong, like a renderer crash or a full disk.
virtual void RegisterServiceWorker(const Scope& pattern,
const GURL& script_url,
const ResultCallback& callback) = 0;
// Equivalent to calling navigator.serviceWorker.unregister(pattern) from a
// renderer, except that |pattern| is an absolute URL instead of relative to
// some current origin. |callback| is passed true when the JS promise is
// fulfilled or false when the JS promise is rejected.
//
// Unregistration can fail if:
// * No Service Worker was registered for |pattern|.
// * Something unexpected goes wrong, like a renderer crash.
virtual void UnregisterServiceWorker(const Scope& pattern,
const ResultCallback& callback) = 0;
// TODO(jyasskin): Provide a way to SendMessage to a Scope.
// Determines if a request for 'url' can be satisfied while offline.
// This method always completes asynchronously.
virtual void CanHandleMainResourceOffline(const GURL& url,
const GURL& first_party,
const net::CompletionCallback&
callback) = 0;
// Methods used in response to browsing data and quota manager requests.
virtual void GetAllOriginsInfo(const GetUsageInfoCallback& callback) = 0;
virtual void DeleteForOrigin(const GURL& origin_url) = 0;
protected:
ServiceWorkerContext() {}
virtual ~ServiceWorkerContext() {}
};
} // namespace content
#endif // CONTENT_PUBLIC_BROWSER_SERVICE_WORKER_CONTEXT_H_
|
