tools/perf/measurements/startup.py

   1 # Copyright 2013 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 from metrics import keychain_metric
   6 from metrics import startup_metric
   7 from telemetry.page import page_test
   8
   9
  10 class Startup(page_test.PageTest):
  11   """Performs a measurement of Chromium's startup performance.
  12
  13   Uses cold start if cold==True, otherwise uses warm start. A cold start means
  14   none of the Chromium files are in the disk cache. A warm start assumes the OS
  15   has already cached much of Chromium's content. For warm tests, you should
  16   repeat the page set to ensure it's cached.
  17   """
  18
  19   def __init__(self, cold=False, action_name_to_run=''):
  20     super(Startup, self).__init__(needs_browser_restart_after_each_page=True,
  21                                   action_name_to_run=action_name_to_run)
  22     self._cold = cold
  23
  24   def CustomizeBrowserOptions(self, options):
  25     if self._cold:
  26       options.clear_sytem_cache_for_browser_and_profile_on_start = True
  27     else:
  28       self.discard_first_result = True
  29
  30     options.AppendExtraBrowserArgs([
  31         '--enable-stats-collection-bindings'
  32     ])
  33     keychain_metric.KeychainMetric.CustomizeBrowserOptions(options)
  34
  35   def RunNavigateSteps(self, page, tab):
  36     # Overriden so that no page navigation occurs - startup to the NTP.
  37     pass
  38
  39   def ValidateAndMeasurePage(self, page, tab, results):
  40     keychain_metric.KeychainMetric().AddResults(tab, results)
  41     startup_metric.StartupMetric().AddResults(tab, results)
  42
  43
  44 class StartWithUrl(Startup):
  45   """Performs a measurement of Chromium's performance starting with a URL.
  46
  47   Uses cold start if cold==True, otherwise uses warm start. A cold start means
  48   none of the Chromium files are in the disk cache. A warm start assumes the OS
  49   has already cached much of Chromium's content. For warm tests, you should
  50   repeat the page set to ensure it's cached.
  51
  52   The startup URL is taken from the page's startup_url. This
  53   allows the testing of multiple different URLs in a single benchmark.
  54   """
  55
  56   def __init__(self, cold=False):
  57     super(StartWithUrl, self).__init__(cold=cold,
  58                                        action_name_to_run='RunPageInteractions')