feat: Add the "keys" instruction

Allow sending key strokes to the browser.

Author: prantlf

Gruntfile.js

@@ -225,6 +225,28 @@ module.exports = function (grunt) {
                   }
                 });
             }
+          },
+          {
+            keys: 'test',
+            wait: function (browser) {
+              return browser.getValue('input')
+                .then(function (value) {
+                  if (value !== 'test') {
+                    throw new Error ('sending text failed');
+                  }
+                });
+            }
+          },
+          {
+            keys: ['Home', 'Delete'],
+            wait: function (browser) {
+              return browser.getValue('input')
+                .then(function (value) {
+                  if (value !== 'est') {
+                    throw new Error ('sending key strokes failed', value);
+                  }
+                });
+            }
           }
         ],
         scenarios: 'test/scenarios/*.js'

README.md

@@ -217,7 +217,18 @@ You can use sub-tasks, `commands` and `scenarios` to structure your code and exe
 
 ### Instructions
 
-One of the instructions has to be present in every command. These properties are evaluated (and their effect is executed) in the order, which they are listed below.
+One of the instructions has to be present in every command. These properties are evaluated (and their effect is executed) in the order, in which they are listed below:
+
+* url
+* go
+* clearValue
+* setValue
+* addValue
+* moveCursor
+* click
+* keys
+* wait
+* file
 
 #### url
 Type: `String`
@@ -337,6 +348,20 @@ Triggers a click event on an element with the specified selector.
 }
 ```
 
+#### keys
+Type: `String|Array`
+
+Sends either a text (string) typed by keys, or single keystrokes (array) to the browser.
+
+```js
+{
+  url: 'https://google.com',
+  click: 'input[name=btnK]',
+  keys: 'test',
+  file: 'google'
+}
+```
+
 #### wait
 Type: `Number` | `String` | `Function` | `Array` (optional)
 
@@ -639,6 +664,7 @@ your code using Grunt.
 
 ## Release History
 
+ * 2018-02-22  [v0.4.0]  Allow sending key strokes to the browser
  * 2018-01-30  [v0.3.0]  Allow specifying test commands in separate modules
  * 2018-01-27  [v0.2.0]  Allow saving screenshots in addition to snapshots
  * 2017-11-18  [v0.1.0]  Allow separate navigation, page interaction and saving snapshots

tasks/html-dom-snapshot.js

@@ -146,6 +146,7 @@ module.exports = function (grunt) {
             clearValue = command.clearValue,
             setValue = command.setValue,
             addValue = command.addValue,
+            keys = command.keys,
             click = command.click,
             viewport = commandOptions.viewport,
             screenshots = commandOptions.screenshots;
@@ -230,6 +231,15 @@ module.exports = function (grunt) {
             return client.click(click);
           }
         })
+        .then(function () {
+          if (keys) {
+            const message = Array.isArray(keys) ?
+              'Send keys "' + keys.join('", "') + '".' :
+              'Send test "' + keys + '".';
+            grunt.verbose.writeln(message);
+            return client.keys(keys);
+          }
+        })
         .then(waitForContent)
         .then(function () {
           if (snapshots && screenshots) {