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
|
// Copyright 2011 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_BACKGROUND_BACKGROUND_CONTENTS_H_
#define CHROME_BROWSER_BACKGROUND_BACKGROUND_CONTENTS_H_
#include <stdint.h>
#include <memory>
#include <string>
#include "base/memory/raw_ptr.h"
#include "base/memory/raw_ref.h"
#include "content/public/browser/site_instance.h"
#include "content/public/browser/web_contents_delegate.h"
#include "content/public/browser/web_contents_observer.h"
#include "extensions/browser/deferred_start_render_host.h"
#include "ui/base/window_open_disposition.h"
#include "url/gurl.h"
class Profile;
namespace content {
class SessionStorageNamespace;
}
namespace extensions {
class ExtensionHostDelegate;
}
// This class maintains a WebContents used in the background. It can host a
// renderer, but does not have any visible display.
// TODO(atwilson): Unify this with background pages; http://crbug.com/77790
class BackgroundContents : public extensions::DeferredStartRenderHost,
public content::WebContentsDelegate,
public content::WebContentsObserver {
public:
class Delegate {
public:
// Called by AddNewContents(). Asks the delegate to attach the opened
// WebContents to a suitable container (e.g. browser) or to show it if it's
// a popup window. If |was_blocked| is non-NULL, then |*was_blocked| will be
// set to true if the popup gets blocked, and left unchanged otherwise.
virtual void AddWebContents(
std::unique_ptr<content::WebContents> new_contents,
const GURL& target_url,
WindowOpenDisposition disposition,
const blink::mojom::WindowFeatures& window_features,
bool* was_blocked) = 0;
// Informs the delegate of lifetime events.
virtual void OnBackgroundContentsNavigated(
BackgroundContents* contents) = 0;
virtual void OnBackgroundContentsTerminated(
BackgroundContents* contents) = 0;
virtual void OnBackgroundContentsClosed(BackgroundContents* contents) = 0;
protected:
virtual ~Delegate() = default;
};
BackgroundContents(
scoped_refptr<content::SiteInstance> site_instance,
content::RenderFrameHost* opener,
bool is_new_browsing_instance,
Delegate* delegate,
const content::StoragePartitionConfig& partition_config,
content::SessionStorageNamespace* session_storage_namespace);
BackgroundContents(const BackgroundContents&) = delete;
BackgroundContents& operator=(const BackgroundContents&) = delete;
~BackgroundContents() override;
content::WebContents* web_contents() const { return web_contents_.get(); }
virtual const GURL& GetURL() const;
// Adds this BackgroundContents to the queue of renderer main frames to create
// and navigate.
void CreateRendererSoon(const GURL& url);
// content::WebContentsDelegate implementation:
void CloseContents(content::WebContents* source) override;
bool ShouldSuppressDialogs(content::WebContents* source) override;
content::WebContents* AddNewContents(
content::WebContents* source,
std::unique_ptr<content::WebContents> new_contents,
const GURL& target_url,
WindowOpenDisposition disposition,
const blink::mojom::WindowFeatures& window_features,
bool user_gesture,
bool* was_blocked) override;
// content::WebContentsObserver implementation:
void PrimaryMainFrameRenderProcessGone(
base::TerminationStatus status) override;
void PrimaryPageChanged(content::Page& page) override;
protected:
// Exposed for testing.
BackgroundContents();
private:
// extensions::DeferredStartRenderHost implementation:
void CreateRendererNow() override;
// The delegate for this BackgroundContents.
raw_ptr<Delegate> delegate_;
// Delegate for choosing an ExtensionHostQueue.
std::unique_ptr<extensions::ExtensionHostDelegate> extension_host_delegate_;
raw_ptr<Profile> profile_;
std::unique_ptr<content::WebContents> web_contents_;
// The initial URL to load.
GURL initial_url_;
};
// This is the data sent out as the details with BACKGROUND_CONTENTS_OPENED.
struct BackgroundContentsOpenedDetails {
// The BackgroundContents object that has just been opened.
raw_ptr<BackgroundContents, DanglingUntriaged> contents;
// The name of the parent frame for these contents.
const raw_ref<const std::string> frame_name;
// The ID of the parent application (if any).
const raw_ref<const std::string> application_id;
};
#endif // CHROME_BROWSER_BACKGROUND_BACKGROUND_CONTENTS_H_
|
