Allow the automation provider to accept an ID for performing render-view

chrome/browser/automation/automation_util.h

 // Copyright (c) 2011 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_AUTOMATION_AUTOMATION_UTIL_H_
 #define CHROME_BROWSER_AUTOMATION_AUTOMATION_UTIL_H_
 #pragma once
 
 #include <string>
 
 #include "base/basictypes.h"
+#include "chrome/common/chrome_view_type.h"
 
+class AutomationId;
 class AutomationProvider;
 class Browser;
+class Extension;
+class ExtensionHost;
 class GURL;
+class Profile;
+class RenderViewHost;
 class TabContents;
+class TabContentsWrapper;
 
 namespace base {
 class DictionaryValue;
 }
 
 namespace IPC {
 class Message;
 }
 
 // This file contains automation utility functions.
@@ skipping 43 matching lines @@
 // See |TestingAutomationProvider| for example input.
 void SetCookieJSON(AutomationProvider* provider,
                    base::DictionaryValue* args,
                    IPC::Message* reply_message);
 
 // Sends a JSON error reply if an app modal dialog is active. Returns whether
 // an error reply was sent.
 bool SendErrorIfModalDialogActive(AutomationProvider* provider,
                                   IPC::Message* message);
 
+// Returns a valid automation ID for the given tab.
+AutomationId GetIdForTab(const TabContentsWrapper* tab);
+
+// Returns a valid automation ID for the extension host.
+AutomationId GetIdForExtensionView(const ExtensionHost* ext_host);
+
+// Returns a valid automation ID for the extension.
+AutomationId GetIdForExtension(const Extension* extension);
+
+// Gets the tab for the given ID. Returns true on success.
+bool GetTabForId(const AutomationId& id, TabContents** tab);
+
+// Gets the render view for the given ID. Returns true on success.
+bool GetRenderViewForId(
+    const AutomationId& id,
+    Profile* profile,
+    RenderViewHost** rvh);
+
+// Returns whether the given ID refers to a actual automation entity.

[dennis_jeffrey, 2011/12/03 00:19:37]

nit: 'a actual' --> 'an actual'

[kkania, 2011/12/03 00:34:31]

Done.

+bool DoesObjectWithIdExist(const AutomationId& id, Profile* profile);
+
 }  // namespace automation_util
 
 #endif  // CHROME_BROWSER_AUTOMATION_AUTOMATION_UTIL_H_