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
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
content / public / common / content_client.h [blame]
// Copyright 2012 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_COMMON_CONTENT_CLIENT_H_
#define CONTENT_PUBLIC_COMMON_CONTENT_CLIENT_H_
#include <set>
#include <string>
#include <string_view>
#include <vector>
#include "base/memory/raw_ptr.h"
#include "base/memory/scoped_refptr.h"
#include "build/build_config.h"
#include "content/common/content_export.h"
#include "mojo/public/cpp/system/message_pipe.h"
#include "ui/base/resource/resource_scale_factor.h"
#include "url/gurl.h"
#include "url/origin.h"
#include "url/url_util.h"
namespace base {
class RefCountedMemory;
class SequencedTaskRunner;
} // namespace base
namespace blink {
class OriginTrialPolicy;
}
namespace gfx {
class Image;
}
namespace gpu {
struct GPUInfo;
}
namespace media {
struct CdmHostFilePath;
class MediaDrmBridgeClient;
}
namespace mojo {
class BinderMap;
}
namespace content {
class ContentBrowserClient;
class ContentClient;
class ContentGpuClient;
class ContentRendererClient;
class ContentUtilityClient;
struct CdmInfo;
struct ContentPluginInfo;
// Setter and getter for the client. The client should be set early, before any
// content code is called.
CONTENT_EXPORT void SetContentClient(ContentClient* client);
#if defined(CONTENT_IMPLEMENTATION)
// Content's embedder API should only be used by content.
ContentClient* GetContentClient();
#endif
// Used for tests to override the relevant embedder interfaces. Each method
// returns the old value. In browser tests it seems safest to call these in
// SetUpOnMainThread() or you may get TSan errors due a race between the
// browser "process" and the child "process" for the test both accessing it.
CONTENT_EXPORT ContentClient* GetContentClientForTesting();
CONTENT_EXPORT ContentBrowserClient* SetBrowserClientForTesting(
ContentBrowserClient* b);
CONTENT_EXPORT ContentRendererClient* SetRendererClientForTesting(
ContentRendererClient* r);
CONTENT_EXPORT ContentUtilityClient* SetUtilityClientForTesting(
ContentUtilityClient* u);
// Interface that the embedder implements.
class CONTENT_EXPORT ContentClient {
public:
ContentClient();
virtual ~ContentClient();
ContentBrowserClient* browser() { return browser_; }
ContentGpuClient* gpu() { return gpu_; }
ContentRendererClient* renderer() { return renderer_; }
ContentUtilityClient* utility() { return utility_; }
// Sets the active URL (the URL of a frame that is navigating or processing an
// IPC message), and the origin of the main frame (for diagnosing crashes).
// Use GURL() or std::string() to clear the URL/origin.
//
// A string is used for the origin because the source of that value may be a
// WebSecurityOrigin or a full URL (if called from the browser process) and a
// string is the lowest-common-denominator.
virtual void SetActiveURL(const GURL& url, std::string top_origin) {}
// Sets the data on the current gpu.
virtual void SetGpuInfo(const gpu::GPUInfo& gpu_info) {}
// Gives the embedder a chance to register its own plugins.
virtual void AddPlugins(std::vector<content::ContentPluginInfo>* plugins) {}
// Returns a list of origins that are allowed to use PDF internal plugin.
virtual std::vector<url::Origin> GetPdfInternalPluginAllowedOrigins();
// Gives the embedder a chance to register the Content Decryption Modules
// (CDM) it supports, as well as the CDM host file paths to verify CDM host.
// |cdms| or |cdm_host_file_paths| can be null which means that specific list
// is not needed.
virtual void AddContentDecryptionModules(
std::vector<content::CdmInfo>* cdms,
std::vector<media::CdmHostFilePath>* cdm_host_file_paths) {}
// Gives the embedder a chance to register its own schemes early in the
// startup sequence.
struct CONTENT_EXPORT Schemes {
Schemes();
~Schemes();
std::vector<std::string> standard_schemes;
std::vector<std::string> referrer_schemes;
std::vector<std::string> savable_schemes;
// Additional schemes that should be allowed to register service workers.
// Only secure and trustworthy schemes should be added.
std::vector<std::string> service_worker_schemes;
// Registers a URL scheme to be treated as a local scheme (i.e., with the
// same security rules as those applied to "file" URLs). This means that
// normal pages cannot link to or access URLs of this scheme.
std::vector<std::string> local_schemes;
// Registers a URL scheme to be treated as a noAccess scheme. This means
// that pages loaded with this URL scheme always have an opaque origin.
std::vector<std::string> no_access_schemes;
// Registers a non-HTTP URL scheme which can be sent CORS requests.
std::vector<std::string> cors_enabled_schemes;
// Registers a URL scheme whose resources can be loaded regardless of a
// page's Content Security Policy.
std::vector<std::string> csp_bypassing_schemes;
// See https://www.w3.org/TR/powerful-features/#is-origin-trustworthy.
std::vector<std::string> secure_schemes;
// Registers a URL scheme as strictly empty documents, allowing them to
// commit synchronously.
std::vector<std::string> empty_document_schemes;
// Registers a URL scheme as extension scheme.
std::vector<std::string> extension_schemes;
// Registers a URL scheme with a predefined default custom handler.
// This pair of strings must be normalized protocol handler parameters as
// described in the Custom Handler specification.
// https://html.spec.whatwg.org/multipage/system-state.html#normalize-protocol-handler-parameters
std::vector<std::pair<std::string, std::string>> predefined_handler_schemes;
#if BUILDFLAG(IS_ANDROID)
// Normally, non-standard schemes canonicalize to opaque origins. However,
// Android WebView requires non-standard schemes to still be preserved.
bool allow_non_standard_schemes_in_origins = false;
#endif
};
virtual void AddAdditionalSchemes(Schemes* schemes) {}
// Returns a string resource given its id.
virtual std::u16string GetLocalizedString(int message_id);
// Returns a string resource given its id and replace $1 with the given
// replacement.
virtual std::u16string GetLocalizedString(int message_id,
const std::u16string& replacement);
// Returns true if GetDataResource would return non-null data for the
// specified |resource_id|.
virtual bool HasDataResource(int resource_id) const;
// Return the contents of a resource in a std::string_view given the resource
// id.
virtual std::string_view GetDataResource(
int resource_id,
ui::ResourceScaleFactor scale_factor);
// Returns the raw bytes of a scale independent data resource.
virtual base::RefCountedMemory* GetDataResourceBytes(int resource_id);
// Returns the string contents of a resource given the resource id.
virtual std::string GetDataResourceString(int resource_id);
// Returns a native image given its id.
virtual gfx::Image& GetNativeImageNamed(int resource_id);
// Called by content::GetProcessTypeNameInEnglish for process types that it
// doesn't know about because they're from the embedder.
virtual std::string GetProcessTypeNameInEnglish(int type);
// Returns the origin trial policy, or nullptr if origin trials are not
// supported by the embedder.
virtual blink::OriginTrialPolicy* GetOriginTrialPolicy();
#if BUILDFLAG(IS_ANDROID)
// Returns true for clients like Android WebView that uses synchronous
// compositor. Note setting this to true will permit synchronous IPCs from
// the browser UI thread.
virtual bool UsingSynchronousCompositing();
// Returns the MediaDrmBridgeClient to be used by media code on Android.
virtual media::MediaDrmBridgeClient* GetMediaDrmBridgeClient();
#endif // BUILDFLAG(IS_ANDROID)
// Allows the embedder to handle incoming interface binding requests from
// the browser process to any type of child process. This is called once
// in each child process during that process's initialization.
virtual void ExposeInterfacesToBrowser(
scoped_refptr<base::SequencedTaskRunner> io_task_runner,
mojo::BinderMap* binders);
private:
// For SetBrowserClientAlwaysAllowForTesting().
friend class BrowserTestBase;
friend class ContentClientInitializer; // To set these pointers.
friend class InternalTestInitializer;
// For SetCanChangeContentBrowserClientForTesting().
friend class ContentBrowserTest;
// For SetCanChangeContentBrowserClientForTesting().
friend class ContentBrowserTestContentBrowserClient;
// Controls whether test code may change the ContentBrowserClient. This is
// used to enforce the right ContentBrowserClient is used.
static void SetCanChangeContentBrowserClientForTesting(bool value);
// Same as SetBrowserClientForTesting(), but always succeeds.
static void SetBrowserClientAlwaysAllowForTesting(ContentBrowserClient* b);
// The embedder API for participating in browser logic.
raw_ptr<ContentBrowserClient, DanglingUntriaged> browser_;
// The embedder API for participating in gpu logic.
raw_ptr<ContentGpuClient> gpu_;
// The embedder API for participating in renderer logic.
raw_ptr<ContentRendererClient> renderer_;
// The embedder API for participating in utility logic.
raw_ptr<ContentUtilityClient> utility_;
};
} // namespace content
#endif // CONTENT_PUBLIC_COMMON_CONTENT_CLIENT_H_