[polymer] Merge of master into polymer10-migration

telemetry/telemetry/internal/browser/web_contents.py

Index: telemetry/telemetry/internal/browser/web_contents.py
diff --git a/telemetry/telemetry/internal/browser/web_contents.py b/telemetry/telemetry/internal/browser/web_contents.py
index 7a03acb0ff7f4b468c1883b063b795a6b0521e93..813234b1a08b142586b1ee19924e602fbfc99cc5 100644
--- a/telemetry/telemetry/internal/browser/web_contents.py
+++ b/telemetry/telemetry/internal/browser/web_contents.py
@@ -307,3 +307,44 @@ class WebContents(object):
         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)