Telemetry media Seek action and metrics.

tools/telemetry/telemetry/page/actions/seek.py

Index: tools/telemetry/telemetry/page/actions/seek.py
diff --git a/tools/telemetry/telemetry/page/actions/seek.py b/tools/telemetry/telemetry/page/actions/seek.py
new file mode 100644
index 0000000000000000000000000000000000000000..6152a689eaff6f14569e81abf67ca89b6bf115de
--- /dev/null
+++ b/tools/telemetry/telemetry/page/actions/seek.py
@@ -0,0 +1,47 @@
+# Copyright (c) 2013 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.
+
+"""A Telemetry page_action that performs the "seek" action on media elements.
+
+Action attributes are:
+- seek_time: The media time to seek to. Test fails if not provided.
+- selector: If no selector is defined then the action attempts to seek the first
+            media element on the page. If 'all' then seek all media elements.
+- log_seek_time: If true the seek time is recorded, otherwise media measurement
+                 will not be aware of the seek action. Used to perform multiple
+                 seeks. Default true.
+- wait_for_seeked: If true forces the action to wait for seeked event to fire.
+                   Default false.
+- wait_timeout: Timeout to wait for seeked event. Only valid with
+                wait_for_seeked=true
+"""
+
+from telemetry.page.actions.media_action import MediaAction
+from telemetry.core import exceptions
+from telemetry.page.actions import page_action
+
+
+class SeekAction(MediaAction):
+  def __init__(self, attributes=None):
+    super(SeekAction, self).__init__(attributes)
+
+  def WillRunAction(self, page, tab):
+    """Load the media metrics JS code prior to running the action."""
+    super(SeekAction, self).WillRunAction(page, tab)
+    self.LoadJS(tab, 'seek.js')
+
+  def RunAction(self, page, tab, previous_action):
+    try:
+      assert hasattr(self, 'seek_time')
+      selector = self.selector if hasattr(self, 'selector') else ''
+      log_seek = self.log_seek if hasattr(self, 'log_seek') else True
+      tab.ExecuteJavaScript('window.__seekMedia("%s", "%s", "%s");' %
+                            (selector, self.seek_time, log_seek))
+      timeout = self.wait_timeout if hasattr(self, 'wait_timeout') else 60
+      # Check if we need to wait for 'seeked' event to fire.
+      if hasattr(self, 'wait_for_seeked') and self.wait_for_seeked:
+        self.WaitForEvent(tab, selector, 'seeked', timeout)
+    except exceptions.EvaluateException:
+      raise page_action.PageActionFailed('Cannot seek media element(s) with '
+                                         'selector = %s.' % selector)