| // Copyright 2015 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 HEADLESS_PUBLIC_HEADLESS_WEB_CONTENTS_H_ |
| #define HEADLESS_PUBLIC_HEADLESS_WEB_CONTENTS_H_ |
| |
| #include "base/callback.h" |
| #include "base/macros.h" |
| #include "headless/public/headless_export.h" |
| #include "ui/gfx/geometry/size.h" |
| #include "url/gurl.h" |
| |
| namespace headless { |
| class HeadlessBrowserContext; |
| class HeadlessBrowserImpl; |
| class HeadlessDevToolsTarget; |
| |
| // Class representing contents of a browser tab. Should be accessed from browser |
| // main thread. |
| class HEADLESS_EXPORT HeadlessWebContents { |
| public: |
| class Builder; |
| |
| virtual ~HeadlessWebContents() {} |
| |
| class Observer { |
| public: |
| // All the following notifications will be called on browser main thread. |
| |
| // Indicates that this HeadlessWebContents instance is now ready to be |
| // inspected using a HeadlessDevToolsClient. |
| // |
| // TODO(altimin): Support this event for pages that aren't created by us. |
| virtual void DevToolsTargetReady() {} |
| |
| protected: |
| Observer() {} |
| virtual ~Observer() {} |
| |
| private: |
| DISALLOW_COPY_AND_ASSIGN(Observer); |
| }; |
| |
| // Add or remove an observer to receive events from this WebContents. |
| // |observer| must outlive this class or be removed prior to being destroyed. |
| virtual void AddObserver(Observer* observer) = 0; |
| virtual void RemoveObserver(Observer* observer) = 0; |
| |
| // Return a DevTools target corresponding to this tab. Note that this method |
| // won't return a valid value until Observer::DevToolsTargetReady has been |
| // signaled. |
| virtual HeadlessDevToolsTarget* GetDevToolsTarget() = 0; |
| |
| // Close this page. |HeadlessWebContents| object will be destroyed. |
| virtual void Close() = 0; |
| |
| private: |
| friend class HeadlessWebContentsImpl; |
| HeadlessWebContents() {} |
| |
| DISALLOW_COPY_AND_ASSIGN(HeadlessWebContents); |
| }; |
| |
| class HEADLESS_EXPORT HeadlessWebContents::Builder { |
| public: |
| ~Builder(); |
| Builder(Builder&&); |
| |
| // Set an initial URL to ensure that the renderer gets initialized and |
| // eventually becomes ready to be inspected. See |
| // HeadlessWebContents::Observer::DevToolsTargetReady. The default URL is |
| // about:blank. |
| Builder& SetInitialURL(const GURL& initial_url); |
| |
| // Specify the initial window size (default is 800x600). |
| Builder& SetWindowSize(const gfx::Size& size); |
| |
| // Set a browser context for storing session data (e.g., cookies, cache, local |
| // storage) for the tab. Several tabs can share the same browser context. If |
| // unset, the default browser context will be used. The browser context must |
| // outlive this HeadlessWebContents. |
| Builder& SetBrowserContext(HeadlessBrowserContext* browser_context); |
| |
| // The returned object is owned by HeadlessBrowser. Call |
| // HeadlessWebContents::Close() to dispose it. |
| HeadlessWebContents* Build(); |
| |
| private: |
| friend class HeadlessBrowserImpl; |
| friend class HeadlessWebContentsImpl; |
| |
| explicit Builder(HeadlessBrowserImpl* browser); |
| |
| HeadlessBrowserImpl* browser_; |
| GURL initial_url_ = GURL("about:blank"); |
| gfx::Size window_size_ = gfx::Size(800, 600); |
| HeadlessBrowserContext* browser_context_; |
| |
| DISALLOW_COPY_AND_ASSIGN(Builder); |
| }; |
| |
| } // namespace headless |
| |
| #endif // HEADLESS_PUBLIC_HEADLESS_WEB_CONTENTS_H_ |