Merge pull request #336 from Frnk1996/patch-2

Add withKeyDown documentation

Author: nunomaduro

browser-testing.md

@@ -281,6 +281,7 @@ $page = visit('/')
 [text](#text)
 [attribute](#attribute)
 [keys](#keys)
+[withKeyDown](#withKeyDown)
 [type](#type)
 [typeSlowly](#type-slowly)
 [select](#select)
@@ -921,6 +922,20 @@ $page->keys('input[name=password]', 'secret');
 $page->keys('input[name=password]', ['{Control}', 'a']); // Keyboard shortcuts
 ```
 
+<a name="withKeyDown"></a>
+### withKeyDown
+
+The `withKeyDown` method executes the given callback while a key is held down:
+
+```php
+$page->withKeyDown('Shift', function () use ($page): void {
+    $page->keys('#input', ['KeyA', 'KeyB', 'KeyC']);
+}); // writes "ABC"
+```
+
+> Note: To respect held keys like Shift, use key codes such as KeyA, KeyB, KeyC.
+> 'a' always types a lowercase “a” and 'A' always types an uppercase “A”, regardless of modifiers.
+
 <a name="type"></a>
 ### type