[polymer] Merge of master into polymer10-migration

telemetry/telemetry/internal/backends/chrome_inspector/inspector_backend.py

 # Copyright 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.
 
 import functools
 import logging
 import os
 import socket
 import sys
 
@@ skipping 257 matching lines @@
 
     if interactionMarkerName is not None:
       params['interactionMarkerName'] = interactionMarkerName
 
     scroll_command = {
       'method': 'Input.synthesizeScrollGesture',
       'params': params
     }
     return self._runtime.RunInspectorCommand(scroll_command, timeout)
 
+  @_HandleInspectorWebSocketExceptions
+  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
+    """
+    params = {
+      'type': keyEventType,
+    }
+
+    if modifiers is not None:
+      params['modifiers'] = modifiers
+    if timestamp is not None:
+      params['timestamp'] = timestamp
+    if text is not None:
+      params['text'] = text
+    if unmodifiedText is not None:
+      params['unmodifiedText'] = unmodifiedText
+    if keyIdentifier is not None:
+      params['keyIdentifier'] = keyIdentifier
+    if domCode is not None:
+      params['code'] = domCode
+    if domKey is not None:
+      params['key'] = domKey
+    if windowsVirtualKeyCode is not None:
+      params['windowsVirtualKeyCode'] = windowsVirtualKeyCode
+    if nativeVirtualKeyCode is not None:
+      params['nativeVirtualKeyCode'] = nativeVirtualKeyCode
+    if autoRepeat is not None:
+      params['autoRepeat'] = autoRepeat
+    if isKeypad is not None:
+      params['isKeypad'] = isKeypad
+    if isSystemKey is not None:
+      params['isSystemKey'] = isSystemKey
+
+    key_command = {
+      'method': 'Input.dispatchKeyEvent',
+      'params': params
+    }
+    return self._runtime.RunInspectorCommand(key_command, timeout)
+
   # Methods used internally by other backends.
 
   def _HandleInspectorDomainNotification(self, res):
     if (res['method'] == 'Inspector.detached' and
         res.get('params', {}).get('reason', '') == 'replaced_with_devtools'):
       self._WaitForInspectorToGoAway()
       return
     if res['method'] == 'Inspector.targetCrashed':
       exception = exceptions.DevtoolsTargetCrashException(self.app)
       self._AddDebuggingInformation(exception)
@@ skipping 49 matching lines @@
       msg = (
           'Received a socket error in the browser connection and the tab no '
           'longer exists. The tab probably crashed.'
       )
     error.AddDebuggingMessage(msg)
     error.AddDebuggingMessage('Debugger url: %s' % self.debugger_url)
 
   @_HandleInspectorWebSocketExceptions
   def CollectGarbage(self):
     self._page.CollectGarbage()