add press key feature

i18n/en.xliff.dist

@@ -443,6 +443,22 @@
                 <source>the response should not be in XML</source>
                 <target></target>
             </trans-unit>
+            <trans-unit id="i-press-key-char">
+                <source>(I )press key :char</source>
+                <target></target>
+            </trans-unit>
+            <trans-unit id="i-press-key-char-with-modifier">
+                <source>(I )press key :char with :modifier</source>
+                <target></target>
+            </trans-unit>
+            <trans-unit id="i-press-key-char-on-element">
+                <source>(I )press key :char on :element</source>
+                <target></target>
+            </trans-unit>
+            <trans-unit id="i-press-key-char-with-modifier-on-element">
+                <source>(I )press key :char with :modifier on :element</source>
+                <target></target>
+            </trans-unit>
         </body>
     </file>
 </xliff>

src/Context/BrowserContext.php

@@ -376,4 +376,22 @@ public function switchToMainFrame()
     {
         $this->getSession()->switchToIFrame();
     }
+
+    /**
+     * Press keyboard key.
+     *
+     * @When (I )press key :char
+     * @When (I )press key :char with :modifier
+     * @When (I )press key :char on :element element
+     * @When (I )press key :char with :modifier on :element element
+     */
+    public function pressKey($char, $modifier = null, $element = 'body')
+    {
+        $node = $this->getSession()->getPage()->find('css', $element);
+        if ($node === null) {
+            throw new \Exception("The element '$element' was not found anywhere in the page");
+        }
+
+        $this->getSession()->getDriver()->keyPress($node->getXPath(), $char, $modifier);
+    }
 }

tests/features/browser.feature

@@ -79,6 +79,13 @@ Feature: Browser Feature
         Then I fill in "today" with the current date
         And I fill in "today" with the current date and modifier "-1 day"
 
+    @javascript
+    Scenario:
+        Given I am on "/browser/elements.html"
+        Then I should not see "key pressed"
+        Then I press key "13"
+        Then I should see "key pressed"
+
 
     Scenario:
         Given I am on "/browser/elements.html"

tests/fixtures/www/browser/elements.html

@@ -18,13 +18,21 @@
     </div>
     <a href="#">First</a>
     <a href="#">Second</a>
+    <p id="keyResponse"></p>
     <form>
         <input type="text" name="today" />
 
         <button type="button" title="Submit">First</button>
         <button type="button" title="Submit">Second</button>
     </form>
     <script>
+        document.getElementsByTagName('body')[0].addEventListener ('keydown', function (event) {
+            if (event.which == 13) {
+                event.preventDefault();
+                document.getElementById('keyResponse').innerHTML = 'key pressed';
+            }
+        });
+
         [].forEach.call(document.querySelectorAll('li, a, button'), function(el) {
                 el.addEventListener('click', function() {
                     document.getElementById('element').innerHTML = 'You clicked ' + el.innerHTML + ' ' + el.tagName;