tools/perf/measurements/smoothness.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 telemetry.page import page_test
   6 from telemetry.timeline import tracing_category_filter
   7 from telemetry.web_perf import timeline_based_measurement
   8 from telemetry.web_perf.metrics import smoothness
   9
  10
  11 class _CustomResultsWrapper(timeline_based_measurement.ResultsWrapperInterface):
  12   def __init__(self):
  13     super(_CustomResultsWrapper, self).__init__()
  14     self._pages_to_tir_labels = {}
  15
  16   def _AssertNewValueHasSameInteractionLabel(self, new_value):
  17     tir_label = self._pages_to_tir_labels.get(new_value.page)
  18     if tir_label:
  19       assert tir_label == self._tir_label, (
  20         'Smoothness measurement do not support multiple interaction record '
  21         'labels per page yet. See crbug.com/453109 for more information.')
  22     else:
  23       self._pages_to_tir_labels[new_value.page] = self._tir_label
  24
  25   def AddValue(self, value):
  26     self._AssertNewValueHasSameInteractionLabel(value)
  27     self._results.AddValue(value)
  28
  29
  30 class Smoothness(page_test.PageTest):
  31   def __init__(self, needs_browser_restart_after_each_page=False):
  32     super(Smoothness, self).__init__(needs_browser_restart_after_each_page)
  33     self._results_wrapper = _CustomResultsWrapper()
  34     self._tbm = None
  35
  36   @classmethod
  37   def CustomizeBrowserOptions(cls, options):
  38     options.AppendExtraBrowserArgs('--enable-gpu-benchmarking')
  39     options.AppendExtraBrowserArgs('--touch-events=enabled')
  40     options.AppendExtraBrowserArgs('--running-performance-benchmark')
  41
  42   def WillNavigateToPage(self, page, tab):
  43     # Collect garbage from previous run several times to make the results more
  44     # stable.
  45     for _ in xrange(0, 5):
  46       tab.CollectGarbage()
  47     tracing_controller = tab.browser.platform.tracing_controller
  48     # FIXME: Remove webkit.console when blink.console lands in chromium and
  49     # the ref builds are updated. crbug.com/386847
  50     custom_categories = [
  51         'webkit.console', 'blink.console', 'benchmark', 'trace_event_overhead']
  52     category_filter = tracing_category_filter.TracingCategoryFilter(
  53         ','.join(custom_categories))
  54
  55     options = timeline_based_measurement.Options(category_filter)
  56     options.SetTimelineBasedMetrics([smoothness.SmoothnessMetric()])
  57     self._tbm = timeline_based_measurement.TimelineBasedMeasurement(
  58         options, self._results_wrapper)
  59     self._tbm.WillRunStoryForPageTest(
  60         tracing_controller, page.GetSyntheticDelayCategories())
  61
  62   def ValidateAndMeasurePage(self, _, tab, results):
  63     tracing_controller = tab.browser.platform.tracing_controller
  64     self._tbm.MeasureForPageTest(tracing_controller, results)
  65
  66   def DidRunPage(self, platform):
  67     if self._tbm:
  68       self._tbm.DidRunStoryForPageTest(platform.tracing_controller)
  69
  70
  71 class Repaint(Smoothness):
  72   def CustomizeBrowserOptions(self, options):
  73     options.AppendExtraBrowserArgs([
  74         '--enable-impl-side-painting',
  75         '--enable-threaded-compositing',
  76         '--enable-gpu-benchmarking'
  77     ])
  78
  79 class SmoothnessWithRestart(Smoothness):
  80   def __init__(self):
  81     super(SmoothnessWithRestart, self).__init__(
  82         needs_browser_restart_after_each_page=True)