Chromium Code Reviews| 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 |