Merge pull request #23 from hyperdivision/type-value

add typeValue helper

Author: bcomnes

README.md

@@ -185,6 +185,10 @@ Accepts a query selector string that resolves to an element or an element.  Call
 
 Dispatches `new window.KeyboardEvent` defaulting to the `keydown` event, for each character in `string`.  Helpful for typing into the currently focused element on screen.  This helper is a WIP, and doesn't work everywhere.  Includes a `t.delay()` call so updates are rendered every keypress.
 
+### `await t.typeValue(elementOrQuerySelector, string, [msg])`
+
+Sumulate typing to an `elementOrQuerySelector` by repeatedly setting the value and waiting for a delay.
+
 ### `await once(emitter, name, [msg])`
 
 Shortcut to use [`'events.once'`](https://github.com/davidmarkclements/events.once#readme), which is useful for catching events as promises.

index.js

@@ -111,6 +111,15 @@ function create (delay, fn) {
         }
         return t.delay().then(() => t.pass(msg))
       },
+      async typeValue (stringOrElement, str, msg) {
+        msg = msg || `Typed by value ${str}${typeof stringOrElement === 'string' ? ` to ${stringOrElement}` : ''}`
+        const el = toElement(stringOrElement)
+        for (const c of str.split('')) {
+          await t.delay()
+          el.value = el.value != null ? el.value + c : c
+        }
+        return t.delay().then(() => t.pass(msg))
+      },
       appendChild (el, msg = 'Appended child to test element') {
         t.element.appendChild(el)
         return t.onload(el, msg).then(t.delay)