headless: Introduce a browser context

headless/public/headless_web_contents.h

 // 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.
@@ skipping 20 matching lines @@
   // 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_