Allow chromedriver to install an extension and get all installed extension IDs.

chrome/browser/automation/automation_provider_json.h

 // Copyright (c) 2010 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.
 
 // Support utilities for the JSON automation interface used by PyAuto.
 
 #ifndef CHROME_BROWSER_AUTOMATION_AUTOMATION_PROVIDER_JSON_H_
 #define CHROME_BROWSER_AUTOMATION_AUTOMATION_PROVIDER_JSON_H_
 #pragma once
 
 #include <string>
 
 #include "base/compiler_specific.h"
 
 class AutomationProvider;
 class Browser;
+class Extension;
+class Profile;
+class RenderViewHost;
 class TabContents;
+class TabContentsWrapper;
 
 namespace base {
 class DictionaryValue;
 class Value;
 }
 
 namespace IPC {
 class Message;
 }
 
@@ skipping 13 matching lines @@
   void SendSuccess(const base::Value* value);
 
   // Send an error reply along with error message |error_message|.
   void SendError(const std::string& error_message);
 
  private:
   AutomationProvider* provider_;
   IPC::Message* message_;
 };
 
+// A unique ID that automation clients can use to refer to browser entities.
+// The ID contains its type so that:
+// 1) supplying an ID of the wrong type can be detected
+// 2) the client does not have to explicitly supply the type in case multiple
+// ID types can be accepted (e.g., can use a tab ID or extension popup ID for
+// executing javascript).
+class AutomationId {
+ public:
+  // This order should be preserved.
+  enum Type {
+    kInvalidType = -1,
+    kTypeTab = 0,
+    kTypeExtensionPopup
+  };
+
+  static bool FromValue(
+      base::Value* value, AutomationId* id, std::string* error);
+
+  AutomationId();
+  AutomationId(Type type, const std::string& id);
+
+  base::Value* ToValue() const;
+
+  bool is_valid() const;
+  Type type() const;
+  const std::string& id() const;
+
+ private:
+  Type type_;
+  std::string id_;
+};
+
 // Gets the browser specified by the given dictionary |args|. |args| should
 // contain a key 'windex' which refers to the index of the browser. Returns
 // true on success and sets |browser|. Otherwise, |error| will be set.
 bool GetBrowserFromJSONArgs(base::DictionaryValue* args,
                             Browser** browser,
                             std::string* error) WARN_UNUSED_RESULT;
 
 // Gets the tab specified by the given dictionary |args|. |args| should
 // contain a key 'windex' which refers to the index of the parent browser,
 // and a key 'tab_index' which refers to the index of the tab in that browser.
 // Returns true on success and sets |tab|. Otherwise, |error| will be set.
 bool GetTabFromJSONArgs(base::DictionaryValue* args,
                         TabContents** tab,
                         std::string* error) WARN_UNUSED_RESULT;
 
 // Gets the browser and tab specified by the given dictionary |args|. |args|
 // should contain a key 'windex' which refers to the index of the browser and
 // a key 'tab_index' which refers to the index of the tab in that browser.
 // Returns true on success and sets |browser| and |tab|. Otherwise, |error|
 // will be set.
 bool GetBrowserAndTabFromJSONArgs(base::DictionaryValue* args,
                                   Browser** browser,
                                   TabContents** tab,
                                   std::string* error) WARN_UNUSED_RESULT;
 
+bool GetAutomationIdFromJSONArgs(
+    base::DictionaryValue* args,
+    AutomationId* id,
+    std::string* error) WARN_UNUSED_RESULT;
+
+bool GetRenderViewFromJSONArgs(
+    base::DictionaryValue* args,
+    Profile* profile,
+    RenderViewHost** rvh,
+    std::string* error) WARN_UNUSED_RESULT;
+
 #endif  // CHROME_BROWSER_AUTOMATION_AUTOMATION_PROVIDER_JSON_H_