Initial implementation of chrome.browser.openTab.

chrome/browser/extensions/extension_tab_util.h

 // Copyright (c) 2012 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_EXTENSIONS_EXTENSION_TAB_UTIL_H_
 #define CHROME_BROWSER_EXTENSIONS_EXTENSION_TAB_UTIL_H_
 
 #include <string>
 
 #include "base/callback.h"
 #include "chrome/common/extensions/api/tabs.h"
 #include "ui/base/window_open_disposition.h"
 
 class Browser;
+class ChromeAsyncExtensionFunction;
 class GURL;
 class Profile;
 class TabStripModel;
 
 namespace base {
 class DictionaryValue;
 class ListValue;
 }
 
 namespace content {
 class WebContents;
 }
 
 namespace gfx {
 class Rect;
 }
 
 namespace extensions {
 class Extension;
 class WindowController;
 
 // Provides various utility functions that help manipulate tabs.
 class ExtensionTabUtil {
  public:
+  struct OpenTabParams {
+    OpenTabParams();
+    ~OpenTabParams();
+
+    bool create_browser_if_needed;
+    scoped_ptr<int> window_id;
+    scoped_ptr<int> opener_tab_id;
+    scoped_ptr<std::string> url;
+    scoped_ptr<bool> active;
+    scoped_ptr<bool> pinned;
+    scoped_ptr<int> index;
+  };
+
+  // Opens a new tab given an extension function |function| and creation
+  // parameters |params|. Returns a Tab object if successful, or NULL and
+  // optionally sets |error| if an error occurs.
+  static base::DictionaryValue* OpenTab(ChromeAsyncExtensionFunction* function,
+                                        const OpenTabParams& params,
+                                        std::string* error);
+
   static int GetWindowId(const Browser* browser);
   static int GetWindowIdOfTabStripModel(const TabStripModel* tab_strip_model);
   static int GetTabId(const content::WebContents* web_contents);
   static std::string GetTabStatusText(bool is_loading);
   static int GetWindowIdOfTab(const content::WebContents* web_contents);
   static base::ListValue* CreateTabList(const Browser* browser,
                                         const Extension* extension);
+  static Browser* GetBrowserFromWindowID(ChromeAsyncExtensionFunction* function,
+                                         int window_id,
+                                         std::string* error_message);
 
   // Creates a Tab object (see chrome/common/extensions/api/tabs.json) with
   // information about the state of a browser tab.  Depending on the
   // permissions of the extension, the object may or may not include sensitive
   // data such as the tab's URL.
   static base::DictionaryValue* CreateTabValue(
       const content::WebContents* web_contents,
       const Extension* extension) {
     return CreateTabValue(web_contents, NULL, -1, extension);
   }
@@ skipping 69 matching lines @@
   static WindowController* GetWindowControllerOfTab(
       const content::WebContents* web_contents);
 
   // Open the extension's options page.
   static void OpenOptionsPage(const Extension* extension, Browser* browser);
 };
 
 }  // namespace extensions
 
 #endif  // CHROME_BROWSER_EXTENSIONS_EXTENSION_TAB_UTIL_H_