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
|
// Copyright 2020 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_COMMON_CONTENT_NAVIGATION_POLICY_H_
#define CONTENT_COMMON_CONTENT_NAVIGATION_POLICY_H_
#include "base/feature_list.h"
#include "content/common/content_export.h"
#include <array>
#include <string>
namespace content {
// Returns whether the BackForwardCache is enabled or not according to the
// feature flags. Note that even if this returns true, the embedder might still
// disable BackForwardCache by returning false in
// `WebContentsDelegate::IsBackForwardCacheSupported()`, which this function
// does not consider.
CONTENT_EXPORT bool IsBackForwardCacheEnabled();
CONTENT_EXPORT bool IsBackForwardCacheDisabledByCommandLine();
CONTENT_EXPORT bool DeviceHasEnoughMemoryForBackForwardCache();
// Whether proactive BrowsingInstance swap can happen on cross-site navigations.
// This can be caused by the BackForwardCache flag.
CONTENT_EXPORT bool CanCrossSiteNavigationsProactivelySwapBrowsingInstances();
// Levels of RenderDocument support. These are additive in that features enabled
// at lower levels remain enabled at all higher levels.
enum class RenderDocumentLevel {
// Do not reuse RenderFrameHosts when recovering from crashes.
kCrashedFrame = 1,
// Do not reuse RenderFrameHosts when navigating non-local-root subframes.
kNonLocalRootSubframe = 2,
// Do not reuse RenderFrameHosts when navigating any subframe.
kSubframe = 3,
// Do not reuse RenderFrameHosts when navigating any frame.
kAllFrames = 4,
};
// Whether same-SiteInstance navigations will result in a change of
// RenderFrameHosts, which will happen when RenderDocument is enabled. Due to
// the various levels of the feature, the result may differ depending on whether
// the RenderFrameHost is a main/local root/non-local-root frame, whether it has
// committed any navigations or not, and whether it's a crashed frame that
// must be replaced or not.
// Note: It is up to the caller to ensure this is called for same-SiteInstance
// navigations.
CONTENT_EXPORT bool ShouldCreateNewRenderFrameHostOnSameSiteNavigation(
bool is_main_frame,
bool is_local_root = true,
bool has_committed_any_navigation = true,
bool must_be_replaced = false);
CONTENT_EXPORT bool ShouldCreateNewHostForAllFrames();
CONTENT_EXPORT RenderDocumentLevel GetRenderDocumentLevel();
CONTENT_EXPORT std::string GetRenderDocumentLevelName(
RenderDocumentLevel level);
CONTENT_EXPORT extern const char kRenderDocumentLevelParameterName[];
// If this is false we continue the old behaviour of doing an early call to
// RenderFrameHostManager::CommitPending when we are replacing a crashed
// frame.
// TODO(crbug.com/40052076): Stop allowing this.
CONTENT_EXPORT bool ShouldSkipEarlyCommitPendingForCrashedFrame();
// The levels for the kQueueNavigationsWhileWaitingForCommit feature.
enum class NavigationQueueingFeatureLevel {
// Feature is disabled.
kNone,
// Navigation code attempts to avoid unnecessary cancellations; otherwise,
// queueing navigations is pointless because the slow-to-commit page will
// simply cancel the queued navigation request.
kAvoidRedundantCancellations,
// Navigation code attempts to queue navigations rather than clobbering a
// speculative RenderFrameHost that is waiting for the renderer to acknowledge
// the navigation commit.
kFull,
};
CONTENT_EXPORT NavigationQueueingFeatureLevel
GetNavigationQueueingFeatureLevel();
// Returns true if GetNavigationQueueingFeatureLevel() returns at least
// kAvoidRedundantCancellations.
CONTENT_EXPORT bool ShouldAvoidRedundantNavigationCancellations();
// Returns true if GetNavigationQueueingFeatureLevel() is kFull.
CONTENT_EXPORT bool ShouldQueueNavigationsWhenPendingCommitRFHExists();
// Returns true if data: URL subframes should be put in a separate SiteInstance
// in the SiteInstanceGroup of the initiator.
CONTENT_EXPORT bool ShouldCreateSiteInstanceForDataUrls();
// Returns true if non-isolated sites should be put in a default
// SiteInstanceGroup in separate SiteInstances, rather than sharing a default
// SiteInstance.
CONTENT_EXPORT bool ShouldUseDefaultSiteInstanceGroup();
} // namespace content
#endif // CONTENT_COMMON_CONTENT_NAVIGATION_POLICY_H_
|
