OLD | NEW |
---|---|
1 // Copyright 2015 The Chromium Authors. All rights reserved. | 1 // Copyright 2015 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef CONTENT_PUBLIC_BROWSER_PERMISSION_MANAGER_H_ | 5 #ifndef CONTENT_PUBLIC_BROWSER_PERMISSION_MANAGER_H_ |
6 #define CONTENT_PUBLIC_BROWSER_PERMISSION_MANAGER_H_ | 6 #define CONTENT_PUBLIC_BROWSER_PERMISSION_MANAGER_H_ |
7 | 7 |
8 #include "content/common/content_export.h" | 8 #include "content/common/content_export.h" |
9 #include "content/public/common/permission_status.mojom.h" | 9 #include "content/public/common/permission_status.mojom.h" |
10 | 10 |
11 class GURL; | 11 class GURL; |
12 | 12 |
13 namespace content { | 13 namespace content { |
14 enum class PermissionType; | 14 enum class PermissionType; |
15 class RenderFrameHost; | 15 class RenderFrameHost; |
16 | 16 |
17 // This class allows the content layer to manipulate permissions. It has to be | 17 // This class allows the content layer to manipulate permissions. It has to be |
18 // implemented by the embedder which ultimately handles the permission | 18 // implemented by the embedder which ultimately handles the permission |
19 // management for the content layer. | 19 // management for the content layer. |
20 class CONTENT_EXPORT PermissionManager { | 20 class CONTENT_EXPORT PermissionManager { |
21 public: | 21 public: |
22 virtual ~PermissionManager() = default; | 22 virtual ~PermissionManager() = default; |
23 | 23 |
24 // Requests a permission on behalf of a frame identified by render_frame_host. | 24 // Requests a permission on behalf of a frame identified by render_frame_host. |
25 // The |request_id| is an identifier that can later be used if the request is | |
26 // cancelled (see CancelPermissionRequest). | |
27 // When the permission request is handled, whether it failed, timed out or | 25 // When the permission request is handled, whether it failed, timed out or |
28 // succeeded, the |callback| will be run. | 26 // succeeded, the |callback| will be run. |
29 virtual void RequestPermission( | 27 // Returns a request id which can be used to cancel the permission (see |
28 // CancelPermissionRequest | |
29 virtual int RequestPermission( | |
30 PermissionType permission, | 30 PermissionType permission, |
31 RenderFrameHost* render_frame_host, | 31 RenderFrameHost* render_frame_host, |
32 int request_id, | |
33 const GURL& requesting_origin, | 32 const GURL& requesting_origin, |
34 bool user_gesture, | 33 bool user_gesture, |
35 const base::Callback<void(PermissionStatus)>& callback) = 0; | 34 const base::Callback<void(PermissionStatus)>& callback) = 0; |
36 | 35 |
37 // Cancels a previously requested permission. The given parameter must match | 36 // Cancels a previous permission request specified by |request_id|. |
mlamouri (slow - plz ping)
2015/09/15 12:36:14
What happens if trying to cancel a permission that
| |
38 // the ones passed to the RequestPermission call. | 37 virtual void CancelPermissionRequest(RenderFrameHost* render_frame_host, |
39 virtual void CancelPermissionRequest(PermissionType permission, | 38 int request_id) = 0; |
40 RenderFrameHost* render_frame_host, | |
41 int request_id, | |
42 const GURL& requesting_origin) = 0; | |
43 | 39 |
44 // Returns the permission status of a given requesting_origin/embedding_origin | 40 // Returns the permission status of a given requesting_origin/embedding_origin |
45 // tuple. This is not taking a RenderFrameHost because the call might happen | 41 // tuple. This is not taking a RenderFrameHost because the call might happen |
46 // outside of a frame context. | 42 // outside of a frame context. |
47 virtual PermissionStatus GetPermissionStatus( | 43 virtual PermissionStatus GetPermissionStatus( |
48 PermissionType permission, | 44 PermissionType permission, |
49 const GURL& requesting_origin, | 45 const GURL& requesting_origin, |
50 const GURL& embedding_origin) = 0; | 46 const GURL& embedding_origin) = 0; |
51 | 47 |
52 // Sets the permission back to its default for the requesting_origin/ | 48 // Sets the permission back to its default for the requesting_origin/ |
(...skipping 19 matching lines...) Expand all Loading... | |
72 | 68 |
73 // Unregisters from permission status change notifications. | 69 // Unregisters from permission status change notifications. |
74 // The |subscription_id| must match the value returned by the | 70 // The |subscription_id| must match the value returned by the |
75 // SubscribePermissionStatusChange call. | 71 // SubscribePermissionStatusChange call. |
76 virtual void UnsubscribePermissionStatusChange(int subscription_id) = 0; | 72 virtual void UnsubscribePermissionStatusChange(int subscription_id) = 0; |
77 }; | 73 }; |
78 | 74 |
79 } // namespace content | 75 } // namespace content |
80 | 76 |
81 #endif // CONTENT_PUBLIC_BROWSER_PERMISSION_MANAGER_H_ | 77 #endif // CONTENT_PUBLIC_BROWSER_PERMISSION_MANAGER_H_ |
OLD | NEW |