WIP

Author: mmalerba

src/cdk/testing/type-in-element.ts

@@ -9,6 +9,14 @@
 import {dispatchFakeEvent, dispatchKeyboardEvent} from './dispatch-events';
 import {triggerFocus} from './element-focus';
 
+/** Modifier keys that may be held while typing. */
+export interface KeyModifiers {
+  control?: boolean;
+  alt?: boolean;
+  shift?: boolean;
+  meta?: boolean;
+}
+
 /**
  * Represents a special key that does not result in a character being inputed in a text field.
  * @docs-private
@@ -30,15 +38,40 @@ export function isTextInput(element: Element): element is HTMLInputElement | HTM
 /**
  * Focuses an input, sets its value and dispatches
  * the `input` event, simulating the user typing.
- * @param value Value to be set on the input.
  * @param element Element onto which to set the value.
+ * @param keys The keys to send to the element.
+ * @docs-private
+ */
+export function typeInElement(element: HTMLElement, ...keys: (string | SpecialKey)[]): void;
+
+/**
+ * Focuses an input, sets its value and dispatches
+ * the `input` event, simulating the user typing.
+ * @param element Element onto which to set the value.
+ * @param modifiers Modifier keys that are held while typing.
+ * @param keys The keys to send to the element.
  * @docs-private
  */
-export function typeInElement(element: HTMLElement, ...value: (string | SpecialKey)[]) {
+export function typeInElement(
+    element: HTMLElement, modifiers: KeyModifiers, ...keys: (string | SpecialKey)[]): void;
+
+export function typeInElement(element: HTMLElement, ...modifiersAndKeys: any) {
+  const first = modifiersAndKeys[0];
+  let modifiers: KeyModifiers;
+  let keys: (string | SpecialKey)[];
+  if (typeof first !== 'string' && first.keyCode === undefined) {
+    modifiers = first;
+    keys = modifiersAndKeys.slice(1);
+  } else {
+    modifiers = {};
+    keys = modifiersAndKeys;
+  }
+
+  // TODO: pass through modifiers
   triggerFocus(element);
-  for (const keys of value) {
-    if (typeof keys === 'string') {
-      for (const key of keys) {
+  for (const keyOrStr of keys) {
+    if (typeof keyOrStr === 'string') {
+      for (const key of keyOrStr) {
         const keyCode = key.charCodeAt(0);
         dispatchKeyboardEvent(element, 'keydown', keyCode);
         dispatchKeyboardEvent(element, 'keypress', keyCode);
@@ -49,9 +82,9 @@ export function typeInElement(element: HTMLElement, ...value: (string | SpecialK
         dispatchKeyboardEvent(element, 'keyup', keyCode);
       }
     } else {
-      dispatchKeyboardEvent(element, 'keydown', keys.keyCode, keys.key);
-      dispatchKeyboardEvent(element, 'keypress', keys.keyCode, keys.key);
-      dispatchKeyboardEvent(element, 'keyup', keys.keyCode, keys.key);
+      dispatchKeyboardEvent(element, 'keydown', keyOrStr.keyCode, keyOrStr.key);
+      dispatchKeyboardEvent(element, 'keypress', keyOrStr.keyCode, keyOrStr.key);
+      dispatchKeyboardEvent(element, 'keyup', keyOrStr.keyCode, keyOrStr.key);
     }
   }
 }