Simulate interactivity boost for simulated user input events

telemetry/telemetry/internal/actions/page_action.py

 # Copyright 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.
 
 from py_trace_event import trace_event
 
 from telemetry import decorators
 from telemetry.util import js_template
 
 
 GESTURE_SOURCE_DEFAULT = 'DEFAULT'
 GESTURE_SOURCE_MOUSE = 'MOUSE'
 GESTURE_SOURCE_TOUCH = 'TOUCH'
 SUPPORTED_GESTURE_SOURCES = (GESTURE_SOURCE_DEFAULT,
                              GESTURE_SOURCE_MOUSE,
                              GESTURE_SOURCE_TOUCH)
 
 class PageActionNotSupported(Exception):
   pass
 
 class PageActionFailed(Exception):
   pass
 
 
 class PageAction(object):
   """Represents an action that a user might try to perform to a page."""
 
   __metaclass__ = trace_event.TracedMetaClass
 
+  def SimulatesUserInput(self):
+    """On some platforms (e.g. ChromeOS), the kernel provides a frequency boost
+    to the CPUs when an input is received (e.g., keypress, touchpad event).
+    Page actions which simulate a user input therefore need to trigger the
+    same boost in order to accurately simulate normal behaviour.
+
+    This should be overridden by actions which simulate user input.
+    """
+    return False
+
   def WillRunAction(self, tab):
     """Override to do action-specific setup before
     Test.WillRunAction is called."""
     pass
 
   def RunAction(self, tab):
     raise NotImplementedError()
 
   def CleanUp(self, tab):
     pass
@@ skipping 95 matching lines @@
   if tab.EvaluateJavaScript("""
       typeof chrome.gpuBenchmarking.gestureSourceTypeSupported ===
           'undefined'"""):
     return (tab.browser.platform.GetOSName() != 'mac' or
             gesture_source_type.lower() != 'touch')
 
   return tab.EvaluateJavaScript("""
       chrome.gpuBenchmarking.gestureSourceTypeSupported(
           chrome.gpuBenchmarking.{{ @gesture_source_type }}_INPUT)""",
       gesture_source_type=gesture_source_type.upper())