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
|
// Copyright 2024 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_PERMISSIONS_SYSTEM_SYSTEM_PERMISSION_SETTINGS_H_
#define CHROME_BROWSER_PERMISSIONS_SYSTEM_SYSTEM_PERMISSION_SETTINGS_H_
#include <memory>
#include "base/auto_reset.h"
#include "base/functional/callback_forward.h"
#include "base/observer_list_types.h"
#include "components/content_settings/core/common/content_settings_types.h"
namespace content {
class WebContents;
}
namespace system_permission_settings {
class PlatformHandle;
using SystemPermissionResponseCallback = base::OnceCallback<void()>;
using content_settings::mojom::ContentSettingsType;
using SystemPermissionChangedCallback =
base::RepeatingCallback<void(ContentSettingsType /*type*/,
bool /*is_blocked*/)>;
class ScopedObservation {
protected:
ScopedObservation() = default;
public:
ScopedObservation(ScopedObservation const&) = delete;
ScopedObservation& operator=(ScopedObservation const&) = delete;
virtual ~ScopedObservation() = default;
};
// For testing purposes only. Sets a fake / mock instance of
// `PlatformHandle` to be used instead of the real implementation.
// This allows tests to control the behavior of system permission checks and
// requests.
void SetInstanceForTesting(PlatformHandle* instance_for_testing);
// Returns `true` if Chrome can request system-level permission. Returns
// `false` otherwise.
bool CanPrompt(ContentSettingsType type);
// For testing purposes only. Mocks that Chrome can request system-level
// permissions.
base::AutoReset<bool> MockSystemPromptForTesting();
// For testing purposes only. Mocks that Chrome doesn't have access to a system
// level permission.
base::AutoReset<bool> MockShowSystemSettingsForTesting();
// Check whether the system blocks the access to the specified content type /
// permission.
bool IsDenied(ContentSettingsType type);
// Check whether the system allows the access to the specified content type /
// permission.
// On some platforms, both IsDenied and IsAllowed may return false for the
// same permission.
bool IsAllowed(ContentSettingsType type);
// Opens the OS page where the user can change the permission settings.
// Implementation is OS specific.
void OpenSystemSettings(content::WebContents* web_contents,
ContentSettingsType type);
// Initiates a system permission request and invokes the provided callback
// once the user's decision is made.
void Request(ContentSettingsType type,
SystemPermissionResponseCallback callback);
std::unique_ptr<ScopedObservation> Observe(
SystemPermissionChangedCallback observer);
class ScopedSettingsForTesting {
public:
ScopedSettingsForTesting(ContentSettingsType type, bool blocked);
~ScopedSettingsForTesting();
private:
ContentSettingsType type_;
};
} // namespace system_permission_settings
#endif // CHROME_BROWSER_PERMISSIONS_SYSTEM_SYSTEM_PERMISSION_SETTINGS_H_
|
