[polymer] Merge of master into polymer10-migration

telemetry/telemetry/internal/browser/web_contents.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.
 
 import os
 
 from telemetry.core import exceptions
 from telemetry.core import util
 
 DEFAULT_WEB_CONTENTS_TIMEOUT = 90
@@ skipping 289 matching lines @@
       exceptions.DevtoolsTargetCrashException
     """
     return self._inspector_backend.SynthesizeScrollGesture(
         x=x, y=y, xDistance=xDistance, yDistance=yDistance,
         xOverscroll=xOverscroll, yOverscroll=yOverscroll,
         preventFling=preventFling, speed=speed,
         gestureSourceType=gestureSourceType, repeatCount=repeatCount,
         repeatDelayMs=repeatDelayMs,
         interactionMarkerName=interactionMarkerName,
         timeout=timeout)
+
+  def DispatchKeyEvent(self, keyEventType='char', modifiers=None,
+                       timestamp=None, text=None, unmodifiedText=None,
+                       keyIdentifier=None, domCode=None, domKey=None,
+                       windowsVirtualKeyCode=None, nativeVirtualKeyCode=None,
+                       autoRepeat=None, isKeypad=None, isSystemKey=None,
+                       timeout=60):
+    """Dispatches a key event to the page.
+
+    Args:
+      type: Type of the key event. Allowed values: 'keyDown', 'keyUp',
+          'rawKeyDown', 'char'.
+      modifiers: Bit field representing pressed modifier keys. Alt=1, Ctrl=2,
+          Meta/Command=4, Shift=8 (default: 0).
+      timestamp: Time at which the event occurred. Measured in UTC time in
+          seconds since January 1, 1970 (default: current time).
+      text: Text as generated by processing a virtual key code with a keyboard
+          layout. Not needed for for keyUp and rawKeyDown events (default: '').
+      unmodifiedText: Text that would have been generated by the keyboard if no
+          modifiers were pressed (except for shift). Useful for shortcut
+          (accelerator) key handling (default: "").
+      keyIdentifier: Unique key identifier (e.g., 'U+0041') (default: '').
+      windowsVirtualKeyCode: Windows virtual key code (default: 0).
+      nativeVirtualKeyCode: Native virtual key code (default: 0).
+      autoRepeat: Whether the event was generated from auto repeat (default:
+          False).
+      isKeypad: Whether the event was generated from the keypad (default:
+          False).
+      isSystemKey: Whether the event was a system key event (default: False).
+
+    Raises:
+      exceptions.TimeoutException
+      exceptions.DevtoolsTargetCrashException
+    """
+    return self._inspector_backend.DispatchKeyEvent(
+        keyEventType=keyEventType, modifiers=modifiers, timestamp=timestamp,
+        text=text, unmodifiedText=unmodifiedText, keyIdentifier=keyIdentifier,
+        domCode=domCode, domKey=domKey,
+        windowsVirtualKeyCode=windowsVirtualKeyCode,
+        nativeVirtualKeyCode=nativeVirtualKeyCode, autoRepeat=autoRepeat,
+        isKeypad=isKeypad, isSystemKey=isSystemKey, timeout=timeout)