Ensures the first browser in each interactive_ui_test is in the foreground

chrome/test/base/in_process_browser_test.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_TEST_BASE_IN_PROCESS_BROWSER_TEST_H_
 #define CHROME_TEST_BASE_IN_PROCESS_BROWSER_TEST_H_
 
 #include <memory>
 
 #include "base/compiler_specific.h"
@@ skipping 100 matching lines @@
   InProcessBrowserTest();
   ~InProcessBrowserTest() override;
 
   // Configures everything for an in process browser test, then invokes
   // BrowserMain. BrowserMain ends up invoking RunTestOnMainThreadLoop.
   void SetUp() override;
 
   // Restores state configured in SetUp.
   void TearDown() override;
 
+  using SetUpBrowserFunction = bool(const Browser*);
+
+  // Sets a function that is called from InProcessBrowserTest::SetUp() on the
+  // first browser. This is intended to set up state applicable to all tests

[msw, 2016/08/29 01:12:29]

nit: s/first/supplied/ or given?

[sky, 2016/08/29 15:51:20]

I changed 'on the' on the previous line to 'with the'.

+  // in the suite. For example, interactive_ui_tests installs a function that
+  // ensures the first browser is in the foreground, active and has focus.
+  static void set_global_browser_set_up_function(
+      SetUpBrowserFunction* set_up_function) {
+    global_browser_set_up_function_ = set_up_function;
+  }
+
  protected:
   // Returns the browser created by CreateBrowser.
   Browser* browser() const { return browser_; }
 
   // Closes the given browser and waits for it to release all its resources.
   void CloseBrowserSynchronously(Browser* browser);
 
   // Closes the browser without waiting for it to release all its resources.
   // WARNING: This may leave tasks posted, but not yet run, in the message
   // loops. Prefer CloseBrowserSynchronously over this method.
@@ skipping 96 matching lines @@
   bool RunAccessibilityChecks(std::string* error_message);
 
  private:
   // Creates a user data directory for the test if one is needed. Returns true
   // if successful.
   virtual bool CreateUserDataDirectory() WARN_UNUSED_RESULT;
 
   // Quits all open browsers and waits until there are no more browsers.
   void QuitBrowsers();
 
+  static SetUpBrowserFunction* global_browser_set_up_function_;
+
   // Browser created from CreateBrowser.
   Browser* browser_;
 
   // Temporary user data directory. Used only when a user data directory is not
   // specified in the command line.
   base::ScopedTempDir temp_user_data_dir_;
 
   // True if we should exit the tests after the last browser instance closes.
   bool exit_when_last_browser_closes_;
 
   // True if the about:blank tab should be opened when the browser is launched.
   bool open_about_blank_on_browser_launch_;
 
   // True if the accessibility test should run for a particular test case.
   // This is reset for every test case.
   bool run_accessibility_checks_for_test_case_;
 
 #if defined(OS_MACOSX)
   base::mac::ScopedNSAutoreleasePool* autorelease_pool_;
   std::unique_ptr<ScopedBundleSwizzlerMac> bundle_swizzler_;
 #endif  // OS_MACOSX
 
 #if defined(OS_WIN)
   std::unique_ptr<base::win::ScopedCOMInitializer> com_initializer_;
 #endif
 };
 
 #endif  // CHROME_TEST_BASE_IN_PROCESS_BROWSER_TEST_H_