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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
// Copyright 2018 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CONTENT_PUBLIC_BROWSER_PERMISSION_CONTROLLER_H_
#define CONTENT_PUBLIC_BROWSER_PERMISSION_CONTROLLER_H_
#include "base/supports_user_data.h"
#include "base/types/id_type.h"
#include "content/common/content_export.h"
#include "content/public/browser/permission_request_description.h"
#include "content/public/browser/permission_result.h"
#include "third_party/blink/public/mojom/permissions/permission_status.mojom.h"
class GURL;
namespace blink {
enum class PermissionType;
}
namespace url {
class Origin;
}
namespace content {
class RenderFrameHost;
class RenderProcessHost;
// This class allows the content layer to manipulate permissions. It's behavior
// is defined by the embedder via PermissionControllerDelegate implementation.
// TODO(crbug.com/1312212): Use url::Origin instead of GURL.
class CONTENT_EXPORT PermissionController
: public base::SupportsUserData::Data {
public:
// Identifier for an active subscription. This is intentionally a distinct
// type from PermissionControllerDelegate::SubscriptionId as the concrete
// identifier values may be different.
using SubscriptionId = base::IdType64<PermissionController>;
~PermissionController() override {}
// Returns the status of the given |permission| for a worker on
// |worker_origin| running in the renderer corresponding to
// |render_process_host|.
virtual PermissionStatus GetPermissionStatusForWorker(
blink::PermissionType permission,
RenderProcessHost* render_process_host,
const url::Origin& worker_origin) = 0;
// Returns the permission status for the current document in the given
// RenderFrameHost. This API takes into account the lifecycle state of a given
// document (i.e. whether it's in back-forward cache or being prerendered) in
// addition to its origin.
virtual PermissionStatus GetPermissionStatusForCurrentDocument(
blink::PermissionType permission,
RenderFrameHost* render_frame_host) = 0;
// The method does the same as `GetPermissionStatusForCurrentDocument` but
// additionally returns a source or reason for the permission status.
virtual PermissionResult GetPermissionResultForCurrentDocument(
blink::PermissionType permission,
RenderFrameHost* render_frame_host) = 0;
// Returns the permission status for a given origin. Use this API only if
// there is no document and it is not a ServiceWorker.
virtual PermissionResult GetPermissionResultForOriginWithoutContext(
blink::PermissionType permission,
const url::Origin& origin) = 0;
// The method does the same as `GetPermissionResultForOriginWithoutContext`
// but it can be used for `PermissionType` that are keyed on a combination of
// requesting and embedding origins, e.g., Notifications or StorageAccess.
virtual PermissionResult GetPermissionResultForOriginWithoutContext(
blink::PermissionType permission,
const url::Origin& requesting_origin,
const url::Origin& embedding_origin) = 0;
// Requests the permission from the current document in the given
// RenderFrameHost. This API takes into account the lifecycle state of a given
// document (i.e. whether it's in back-forward cache or being prerendered) in
// addition to its origin.
// TODO(crbug.com/1462930): Remove this function.
virtual void RequestPermissionFromCurrentDocument(
RenderFrameHost* render_frame_host,
PermissionRequestDescription request_description,
base::OnceCallback<void(PermissionStatus)> callback) = 0;
// RenderFrameHost. This API takes into account the lifecycle state of a given
// document (i.e. whether it's in back-forward cache or being prerendered) in
// addition to its origin.
// WARNING: Permission requests order is not guaranteed.
// TODO(crbug.com/1363094): Migrate to `std::set`.
virtual void RequestPermissionsFromCurrentDocument(
RenderFrameHost* render_frame_host,
PermissionRequestDescription request_description,
base::OnceCallback<void(const std::vector<PermissionStatus>&)>
callback) = 0;
// Sets the permission back to its default for the `origin`.
virtual void ResetPermission(blink::PermissionType permission,
const url::Origin& origin) = 0;
virtual SubscriptionId SubscribePermissionStatusChange(
blink::PermissionType permission,
RenderProcessHost* render_process_host,
const url::Origin& requesting_origin,
const base::RepeatingCallback<void(PermissionStatus)>& callback) = 0;
virtual void UnsubscribePermissionStatusChange(
SubscriptionId subscription_id) = 0;
// Returns `true` if a document subscribed to
// `PermissionStatus.onchange` listener or `PermissionStatus.AddEventListener`
// with a type `change` was added. Returns `false` otherwise.
virtual bool IsSubscribedToPermissionChangeEvent(
blink::PermissionType permission,
RenderFrameHost* render_frame_host) = 0;
};
} // namespace content
namespace std {
template <>
struct hash<content::PermissionController::SubscriptionId> {
std::size_t operator()(
const content::PermissionController::SubscriptionId& v) const {
content::PermissionController::SubscriptionId::Hasher hasher;
return hasher(v);
}
};
} // namespace std
#endif // CONTENT_PUBLIC_BROWSER_PERMISSION_CONTROLLER_H_
|
