Provide ability for WebUIBrowserTests to run asynchronous tests.

chrome/browser/ui/webui/web_ui_browsertest.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_UI_WEBUI_WEB_UI_BROWSERTEST_H_
 #define CHROME_BROWSER_UI_WEBUI_WEB_UI_BROWSERTEST_H_
 #pragma once
 
 #include <string>
 
@@ skipping 54 matching lines @@
   // Runs a test that may include calls to functions in test_api.js.
   bool RunJavascriptTest(const std::string& test_name);
   bool RunJavascriptTest(const std::string& test_name,
                          const base::Value& arg);
   bool RunJavascriptTest(const std::string& test_name,
                          const base::Value& arg1,
                          const base::Value& arg2);
   bool RunJavascriptTest(const std::string& test_name,
                          const ConstValueVector& test_arguments);
 
+  // Runs a test that may include calls to functions in test_api.js, and waits
+  // for call to asyncTestDone().
+  bool RunJavascriptAsyncTest(const std::string& test_name);
+  bool RunJavascriptAsyncTest(const std::string& test_name,
+                              const base::Value& arg);
+  bool RunJavascriptAsyncTest(const std::string& test_name,
+                              const base::Value& arg1,
+                              const base::Value& arg2);
+  bool RunJavascriptAsyncTest(const std::string& test_name,
+                              const ConstValueVector& test_arguments);
+
   // Sends message through |preload_host| to preload javascript libraries and
   // sets the |libraries_preloaded| flag to prevent re-loading at next
   // javascript invocation.
   void PreLoadJavascriptLibraries(const std::string& preload_test_fixture,
                                   const std::string& preload_test_name,
                                   RenderViewHost* preload_host);
 
   // Called by javascript-generated test bodies to browse to a page and preload
   // the javascript for the given |preload_test_fixture| and
   // |preload_test_name|. chrome.send will be overridden to allow javascript
@@ skipping 24 matching lines @@
   static GURL WebUITestDataPathToURL(const FilePath::StringType& path);
 
  private:
   // TestNavigationObserver::JsInjectionReadyObserver implementation.
   virtual void OnJsInjectionReady(RenderViewHost* render_view_host) OVERRIDE;
 
   // Builds a string containing all added javascript libraries.
   void BuildJavascriptLibraries(string16* content);
 
   // Builds a string with a call to the runTest JS function, passing the
-  // given test and its arguments.
-  string16 BuildRunTestJSCall(const std::string& test_name,
+  // given |is_async|, |test_name| and its |args|.
+  string16 BuildRunTestJSCall(bool is_async,
+                              const std::string& test_name,
                               const WebUIBrowserTest::ConstValueVector& args);
 
   // Loads all libraries added with AddLibrary(), and calls |function_name| with
   // |function_arguments|. When |is_test| is true, the framework wraps
   // |function_name| with a test helper function, which waits for completion,
   // logging an error message on failure, otherwise |function_name| is called
   // asynchronously. When |preload_host| is non-NULL, sends the javascript to
   // the RenderView for evaluation at the appropriate time before the onload
-  // call is made.
+  // call is made. Passes |is_async| along to runTest wrapper.
   bool RunJavascriptUsingHandler(const std::string& function_name,
                                  const ConstValueVector& function_arguments,
                                  bool is_test,
+                                 bool is_async,
                                  RenderViewHost* preload_host);
 
   // Attaches mock and test handlers.
   void SetupHandlers();
 
   // Handles test framework messages.
   scoped_ptr<WebUITestHandler> test_handler_;
 
   // Location of test data (currently test/data/webui).
   FilePath test_data_directory_;
 
   // User added libraries
   std::vector<FilePath> user_libraries_;
 
   // Indicates that the libraries have been pre-loaded and to not load them
   // again.
   bool libraries_preloaded_;
 
   // Saves the states of |test_fixture| and |test_name| for calling
   // PreloadJavascriptLibraries().
   std::string preload_test_fixture_;
   std::string preload_test_name_;
 };
 
 #endif  // CHROME_BROWSER_UI_WEBUI_WEB_UI_BROWSERTEST_H_