| // 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() {} |
| }; |
| |
| 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; |
| void 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; |
| bool IsNeverComposited(content::WebContents* web_contents) 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_ |