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
|
// Copyright (c) 2011 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 CHROME_BROWSER_BACKGROUND_BACKGROUND_CONTENTS_H_
#define CHROME_BROWSER_BACKGROUND_BACKGROUND_CONTENTS_H_
#include <string>
#include "base/memory/scoped_ptr.h"
#include "base/observer_list.h"
#include "content/public/browser/notification_observer.h"
#include "content/public/browser/notification_registrar.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;
class SiteInstance;
};
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 content::NotificationObserver {
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(content::WebContents* new_contents,
WindowOpenDisposition disposition,
const gfx::Rect& initial_rect,
bool user_gesture,
bool* was_blocked) = 0;
protected:
virtual ~Delegate() {}
};
BackgroundContents(
content::SiteInstance* site_instance,
int routing_id,
int main_frame_routing_id,
Delegate* delegate,
const std::string& partition_id,
content::SessionStorageNamespace* session_storage_namespace);
~BackgroundContents() override;
content::WebContents* web_contents() const { return web_contents_.get(); }
virtual const GURL& GetURL() const;
// Adds this BackgroundContents to the queue of RenderViews to create.
void CreateRenderViewSoon(const GURL& url);
// content::WebContentsDelegate implementation:
void CloseContents(content::WebContents* source) override;
bool ShouldSuppressDialogs(content::WebContents* source) override;
void DidNavigateMainFramePostCommit(content::WebContents* tab) override;
void AddNewContents(content::WebContents* source,
content::WebContents* new_contents,
WindowOpenDisposition disposition,
const gfx::Rect& initial_rect,
bool user_gesture,
bool* was_blocked) override;
bool IsNeverVisible(content::WebContents* web_contents) override;
// content::WebContentsObserver implementation:
void RenderProcessGone(base::TerminationStatus status) override;
void DidStartLoading() override;
void DidStopLoading() override;
// content::NotificationObserver
void Observe(int type,
const content::NotificationSource& source,
const content::NotificationDetails& details) override;
protected:
// Exposed for testing.
BackgroundContents();
private:
// extensions::DeferredStartRenderHost implementation:
void CreateRenderViewNow() override;
void AddDeferredStartRenderHostObserver(
extensions::DeferredStartRenderHostObserver* observer) override;
void RemoveDeferredStartRenderHostObserver(
extensions::DeferredStartRenderHostObserver* observer) override;
// The delegate for this BackgroundContents.
Delegate* delegate_;
// Delegate for choosing an ExtensionHostQueue.
scoped_ptr<extensions::ExtensionHostDelegate> extension_host_delegate_;
Profile* profile_;
scoped_ptr<content::WebContents> web_contents_;
content::NotificationRegistrar registrar_;
base::ObserverList<extensions::DeferredStartRenderHostObserver>
deferred_start_render_host_observer_list_;
// The initial URL to load.
GURL initial_url_;
DISALLOW_COPY_AND_ASSIGN(BackgroundContents);
};
// This is the data sent out as the details with BACKGROUND_CONTENTS_OPENED.
struct BackgroundContentsOpenedDetails {
// The BackgroundContents object that has just been opened.
BackgroundContents* contents;
// The name of the parent frame for these contents.
const base::string16& frame_name;
// The ID of the parent application (if any).
const base::string16& application_id;
};
#endif // CHROME_BROWSER_BACKGROUND_BACKGROUND_CONTENTS_H_
|
