Add ScrollPageToElement to action_runner.

telemetry/telemetry/internal/actions/action_runner.py

 # Copyright 2014 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.
 
 import logging
 import time
 import urlparse
 
 from telemetry.internal.actions.drag import DragAction
 from telemetry.internal.actions.javascript_click import ClickElementAction
 from telemetry.internal.actions.key_event import KeyPressAction
 from telemetry.internal.actions.load_media import LoadMediaAction
 from telemetry.internal.actions.loop import LoopAction
 from telemetry.internal.actions.mouse_click import MouseClickAction
 from telemetry.internal.actions.navigate import NavigateAction
 from telemetry.internal.actions.page_action import GESTURE_SOURCE_DEFAULT
 from telemetry.internal.actions.page_action import SUPPORTED_GESTURE_SOURCES
 from telemetry.internal.actions.pinch import PinchAction
 from telemetry.internal.actions.play import PlayAction
 from telemetry.internal.actions.repaint_continuously import (
     RepaintContinuouslyAction)
 from telemetry.internal.actions.repeatable_scroll import RepeatableScrollAction
 from telemetry.internal.actions.scroll import ScrollAction
 from telemetry.internal.actions.scroll_bounce import ScrollBounceAction
+from telemetry.internal.actions.scroll_to_element import ScrollToElementAction
 from telemetry.internal.actions.seek import SeekAction
 from telemetry.internal.actions.swipe import SwipeAction
 from telemetry.internal.actions.tap import TapAction
 from telemetry.internal.actions.wait import WaitForElementAction
 from telemetry.web_perf import timeline_interaction_record
 
 
 _DUMP_WAIT_TIME = 3
 
 
@@ skipping 351 matching lines @@
       synthetic_gesture_source: the source input device type for the
           synthetic gesture: 'DEFAULT', 'TOUCH' or 'MOUSE'.
     """
     assert synthetic_gesture_source in SUPPORTED_GESTURE_SOURCES
     self._RunAction(ScrollAction(
         left_start_ratio=left_start_ratio, top_start_ratio=top_start_ratio,
         direction=direction, distance=distance, distance_expr=distance_expr,
         speed_in_pixels_per_second=speed_in_pixels_per_second,
         use_touch=use_touch, synthetic_gesture_source=synthetic_gesture_source))
 
+  def ScrollPageToElement(self, selector=None, element_function=None):
+    """Perform scroll gesture on page until an element is in view.
+
+    Args:
+      selector: A CSS selector describing the element.
+      text: The element must contains this exact text.

[charliea (OOO until 10-5), 2016/10/14 03:34:28]

|text| isn't an arg here. bad c/p?

[rnephew (Reviews Here), 2016/10/14 17:57:17]

Done.

+      element_function: A JavaScript function (as string) that is used
+          to retrieve the element. For example:
+          'function() { return foo.element; }'.
+    """
+    self._RunAction(ScrollToElementAction(
+        selector=selector, element_function=element_function))
+
   def RepeatableBrowserDrivenScroll(self, x_scroll_distance_ratio=0.0,
                                     y_scroll_distance_ratio=0.5,
                                     repeat_count=0,
                                     repeat_delay_ms=250,
                                     timeout=60,
                                     prevent_fling=None,
                                     speed=None):
     """Perform a browser driven repeatable scroll gesture.
 
     The scroll gesture is driven from the browser, this is useful because the
@@ skipping 375 matching lines @@
         timeline_interaction_record.GetJavaScriptMarker(
         self._label, self._flags))
 
   def End(self):
     assert self._started
     self._started = False
     self._action_runner.ExecuteJavaScript(
         'console.timeEnd("%s");' %
         timeline_interaction_record.GetJavaScriptMarker(
         self._label, self._flags))