Add ExecuteJavascript() method to PyUITestBase

chrome/test/pyautolib/pyautolib.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.
 //
 // This file declares the C++ side of PyAuto, the python interface to
 // Chromium automation.  It access Chromium's internals using Automation Proxy.
 
 #ifndef CHROME_TEST_PYAUTOLIB_PYAUTOLIB_H_
 #define CHROME_TEST_PYAUTOLIB_PYAUTOLIB_H_
 #pragma once
@@ skipping 130 matching lines @@
   bool RemoveBookmark(std::wstring& id);
 
   // Get a handle to browser window at the given index, or NULL on failure.
   scoped_refptr<BrowserProxy> GetBrowserWindow(int window_index);
 
   // Meta-method.  Experimental pattern of passing args and response as
   // JSON dict to avoid future use of the SWIG interface and
   // automation proxy additions.  Returns response as JSON dict.
   std::string _SendJSONRequest(int window_index, std::string& request);
 
+  // Execute javascript in a given tab, and return the response. This is
+  // a low-level method intended for use mostly by GetDOMValue(). Note that
+  // any complicated manipulation of the page should be done by something
+  // like WebDriver, not PyAuto.

[John Grabowski, 2010/08/03 06:42:45]

Clarify that the only return value is something set by
window.domAutomationController.send().

[Dirk Pranke, 2010/08/04 21:44:12]

Done.

+  std::wstring ExecuteJavascript(const std::wstring& script,
+                                 int window_index = 0,
+                                 int tab_index = 0,
+                                 const std::wstring& frame_xpath = L"");
+
+  // Evaluate a Javascript expression and return the result as a string. This
+  // method is intended largely to read values out of the frame DOM.
+  std::wstring GetDOMValue(const std::wstring& expr,
+                           int window_index = 0,
+                           int tab_index = 0,
+                           const std::wstring& frame_xpath = L"");
+
   // Resets to the default theme. Returns true on success.
   bool ResetToDefaultTheme();
 
   // Sets a cookie value for a url. Returns true on success.
   bool SetCookie(const GURL& cookie_url, const std::string& value,
                  int window_index = 0, int tab_index = 0);
   // Gets a cookie value for the given url.
   std::string GetCookie(const GURL& cookie_url, int window_index = 0,
                         int tab_index = 0);
 
  private:
   // Enables PostTask to main thread.
   // Should be shared across multiple instances of PyUITestBase so that this
   // class is re-entrant and multiple instances can be created.
   // This is necessary since python's unittest module creates instances of
   // TestCase at load time itself.
   static MessageLoop* GetSharedMessageLoop(MessageLoop::Type msg_loop_type);
   static MessageLoop* message_loop_;
 };
 
 #endif  // CHROME_TEST_PYAUTOLIB_PYAUTOLIB_H_