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
|
// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef THIRD_PARTY_BLINK_PUBLIC_WEB_WEB_REMOTE_FRAME_H_
#define THIRD_PARTY_BLINK_PUBLIC_WEB_WEB_REMOTE_FRAME_H_
#include "third_party/blink/public/common/permissions_policy/permissions_policy.h"
#include "third_party/blink/public/common/tokens/tokens.h"
#include "third_party/blink/public/mojom/frame/frame_owner_element_type.mojom-shared.h"
#include "third_party/blink/public/mojom/frame/user_activation_notification_type.mojom-shared.h"
#include "third_party/blink/public/mojom/frame/user_activation_update_types.mojom-shared.h"
#include "third_party/blink/public/mojom/security_context/insecure_request_policy.mojom-shared.h"
#include "third_party/blink/public/platform/web_policy_container.h"
#include "third_party/blink/public/web/web_frame.h"
#include "ui/events/types/scroll_types.h"
#include "v8/include/v8.h"
namespace blink {
namespace mojom {
enum class TreeScopeType;
}
class AssociatedInterfaceProvider;
class InterfaceRegistry;
class WebElement;
class WebLocalFrameClient;
class WebRemoteFrameClient;
class WebString;
class WebView;
struct FramePolicy;
struct FrameVisualProperties;
struct WebFrameOwnerProperties;
class WebRemoteFrame : public WebFrame {
public:
// Factory methods for creating a WebRemoteFrame. The WebRemoteFrameClient
// argument must be non-null for all creation methods.
BLINK_EXPORT static WebRemoteFrame* Create(
mojom::TreeScopeType,
WebRemoteFrameClient*,
InterfaceRegistry*,
AssociatedInterfaceProvider*,
const RemoteFrameToken& frame_token);
BLINK_EXPORT static WebRemoteFrame* CreateMainFrame(
WebView*,
WebRemoteFrameClient*,
InterfaceRegistry*,
AssociatedInterfaceProvider*,
const RemoteFrameToken& frame_token,
const base::UnguessableToken& devtools_frame_token,
WebFrame* opener);
// Also performs core initialization to associate the created remote frame
// with the provided <portal> or <fencedframe> element.
BLINK_EXPORT static WebRemoteFrame* CreateForPortalOrFencedFrame(
mojom::TreeScopeType,
WebRemoteFrameClient*,
InterfaceRegistry*,
AssociatedInterfaceProvider*,
const RemoteFrameToken& frame_token,
const base::UnguessableToken& devtools_frame_token,
const WebElement& frame_owner);
// Specialized factory methods to allow the embedder to replicate the frame
// tree between processes.
// TODO(dcheng): The embedder currently does not replicate local frames in
// insertion order, so the local child version takes |previous_sibling| to
// ensure that it is inserted into the correct location in the list of
// children. If |previous_sibling| is null, the child is inserted at the
// beginning.
virtual WebLocalFrame* CreateLocalChild(
mojom::TreeScopeType,
const WebString& name,
const FramePolicy&,
WebLocalFrameClient*,
InterfaceRegistry*,
WebFrame* previous_sibling,
const WebFrameOwnerProperties&,
const LocalFrameToken& frame_token,
WebFrame* opener,
std::unique_ptr<WebPolicyContainer> policy_container) = 0;
virtual WebRemoteFrame* CreateRemoteChild(
mojom::TreeScopeType,
const WebString& name,
const FramePolicy&,
WebRemoteFrameClient*,
InterfaceRegistry*,
AssociatedInterfaceProvider*,
const RemoteFrameToken& frame_token,
const base::UnguessableToken& devtools_frame_token,
WebFrame* opener) = 0;
// Set security origin replicated from another process.
virtual void SetReplicatedOrigin(
const WebSecurityOrigin&,
bool is_potentially_trustworthy_opaque_origin) = 0;
// Set sandbox flags replicated from another process.
virtual void SetReplicatedSandboxFlags(network::mojom::WebSandboxFlags) = 0;
// Set frame |name| and |unique_name| replicated from another process.
virtual void SetReplicatedName(const WebString& name,
const WebString& unique_name) = 0;
// Sets the Permissions Policy header for the main frame.
virtual void SetReplicatedPermissionsPolicyHeader(
const ParsedPermissionsPolicy& parsed_header) = 0;
// Set frame enforcement of insecure request policy replicated from another
// process.
virtual void SetReplicatedInsecureRequestPolicy(
mojom::InsecureRequestPolicy) = 0;
virtual void SetReplicatedInsecureNavigationsSet(
const WebVector<unsigned>&) = 0;
virtual void SetReplicatedIsAdSubframe(bool is_ad_subframe) = 0;
virtual void DidStartLoading() = 0;
// Update the user activation state in appropriate part of this frame's
// "local" frame tree (ancestors-only vs all-nodes).
//
// The |notification_type| parameter is used for histograms, only for the case
// |update_state == kNotifyActivation|.
virtual void UpdateUserActivationState(
mojom::UserActivationUpdateType update_type,
mojom::UserActivationNotificationType notification_type) = 0;
virtual void SetHadStickyUserActivationBeforeNavigation(bool value) = 0;
// Unique name is an opaque identifier for maintaining association with
// session restore state for this frame.
virtual WebString UniqueName() const = 0;
virtual const FrameVisualProperties& GetPendingVisualPropertiesForTesting()
const = 0;
RemoteFrameToken GetRemoteFrameToken() const {
return GetFrameToken().GetAs<RemoteFrameToken>();
}
// Ad Tagging ---------------------------------------------------------
// True if the frame is thought (heuristically) to be created for
// advertising purposes.
bool IsAdSubframe() const override = 0;
protected:
explicit WebRemoteFrame(mojom::TreeScopeType scope,
const RemoteFrameToken& frame_token)
: WebFrame(scope, frame_token) {}
// Inherited from WebFrame, but intentionally hidden: it never makes sense
// to call these on a WebRemoteFrame.
bool IsWebLocalFrame() const override = 0;
WebLocalFrame* ToWebLocalFrame() override = 0;
bool IsWebRemoteFrame() const override = 0;
WebRemoteFrame* ToWebRemoteFrame() override = 0;
};
} // namespace blink
#endif // THIRD_PARTY_BLINK_PUBLIC_WEB_WEB_REMOTE_FRAME_H_
|
