chrome/browser/task_manager/task_manager_browsertest_util.h

   1 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_BROWSER_TASK_MANAGER_TASK_MANAGER_BROWSERTEST_UTIL_H_
   6 #define CHROME_BROWSER_TASK_MANAGER_TASK_MANAGER_BROWSERTEST_UTIL_H_
   7
   8 #include "base/strings/string16.h"
   9
  10 namespace task_manager {
  11 namespace browsertest_util {
  12
  13 // For the old task manager browser tests, we must call this to disable the
  14 // use of the new implementation and revert back to the old one.
  15 void EnableOldTaskManager();
  16
  17 // Runs the message loop, observing the task manager, until there are exactly
  18 // |resource_count| many resources whose titles match the pattern
  19 // |title_pattern|. The match is done via string_util's base::MatchPattern, so
  20 // |title_pattern| may contain wildcards like "*".
  21 //
  22 // If the wait times out, this test will trigger a gtest failure. To get
  23 // meaningful errors, tests should wrap invocations of this function with
  24 // ASSERT_NO_FATAL_FAILURE().
  25 void WaitForTaskManagerRows(int resource_count,
  26                             const base::string16& title_pattern);
  27
  28 // Specifies some integer-valued column of numeric data reported by the task
  29 // manager model. Please add more here as needed by tests.
  30 enum ColumnSpecifier {
  31   V8_MEMORY,
  32   V8_MEMORY_USED,
  33   SQLITE_MEMORY_USED,
  34
  35   COLUMN_NONE,  // Default value.
  36 };
  37
  38 // Waits for the row identified by |title_pattern| to be showing a numeric data
  39 // value of at least |min_column_value| in the task manager column identified by
  40 // |column_specifier|. As with WaitForTaskManagerRows(), |title_pattern| is
  41 // meant to be a string returned by MatchTab() or similar.
  42 //
  43 // To get meaningful errors, tests should wrap invocations of this function with
  44 // ASSERT_NO_FATAL_FAILURE().
  45 void WaitForTaskManagerStatToExceed(const base::string16& title_pattern,
  46                                     ColumnSpecifier column_specifier,
  47                                     size_t min_column_value);
  48
  49 // ASCII matcher convenience functions for use with WaitForTaskManagerRows()
  50 base::string16 MatchTab(const char* title);         // "Tab: " + title
  51 base::string16 MatchAnyTab();                       // "Tab: *"
  52 base::string16 MatchAboutBlankTab();                // "Tab: about:blank"
  53 base::string16 MatchExtension(const char* title);   // "Extension: " + title
  54 base::string16 MatchAnyExtension();                 // "Extension: *"
  55 base::string16 MatchApp(const char* title);         // "App: " + title
  56 base::string16 MatchAnyApp();                       // "App: *"
  57 base::string16 MatchWebView(const char* title);     // "WebView: " + title
  58 base::string16 MatchAnyWebView();                   // "WebView: *"
  59 base::string16 MatchBackground(const char* title);  // "Background: " + title
  60 base::string16 MatchAnyBackground();                // "Background: *"
  61 base::string16 MatchPrint(const char* title);       // "Print: " + title
  62 base::string16 MatchAnyPrint();                     // "Print: *"
  63 base::string16 MatchSubframe(const char* title);    // "Subframe: " + title
  64 base::string16 MatchAnySubframe();                  // "Subframe: *"
  65 // "Utility: " + title
  66 base::string16 MatchUtility(const base::string16& title);
  67 base::string16 MatchAnyUtility();                   // "Utility: *"
  68
  69 }  // namespace browsertest_util
  70 }  // namespace task_manager
  71
  72 #endif  // CHROME_BROWSER_TASK_MANAGER_TASK_MANAGER_BROWSERTEST_UTIL_H_