docs: updates cy.press() documentation to include expanded named keys, as well as utf-8 characters

Author: cacieprins

docs/api/commands/press.mdx

@@ -14,9 +14,7 @@ Trigger native key events in your application to simulate keyboard interactions.
 
 A `keydown`, `press`, and `keyup` event will be dispatched directly to the browser window.
 
-Unlike `cy.type()`, which is best for typing character keys, `cy.press()` will dispatch real keyboard events rather than simulated ones. This command is especially useful when testing focus management and keyboard navigation patterns which are critical for [accessibility testing](/app/guides/accessibility-testing) and great keyboard UX.
-
-Currently, the only key supported is `Tab`.
+Unlike `cy.type()`, which is best for typing multiple character keys, `cy.press()` will dispatch real keyboard events rather than simulated ones. This command is especially useful when testing focus management and keyboard navigation patterns which are critical for [accessibility testing](/app/guides/accessibility-testing) and great keyboard UX.
 
 :::caution
 
@@ -68,13 +66,69 @@ cy.press(Cypress.Keyboard.Keys.TAB)
 
 <Icon name="angle-right" /> **key _(String)_**
 
-The key to press. The supported values are available on [`Cypress.Keyboard.Keys`](/api/cypress-api/keyboard-api), and may change from time to time. It's recomended that you reference these values from `Cypress.Keyboard.Keys` rather than passing in a string.
+The key to press. The supported values are available on [`Cypress.Keyboard.Keys`](/api/cypress-api/keyboard-api), and may change from time to time. It's recommended that you reference these values from `Cypress.Keyboard.Keys` rather than passing in a string.
 
 ### Supported Keys
 
 | Reference                   | Value   |
 | --------------------------- | ------- |
+| `Cypress.Keyboard.Keys.DOWN` | `"ArrowDown"` |
+| `Cypress.Keyboard.Keys.LEFT` | `"ArrowLeft"` |
+| `Cypress.Keyboard.Keys.RIGHT` | `"ArrowRight"` |
+| `Cypress.Keyboard.Keys.UP` | `"ArrowUp"` |
+| `Cypress.Keyboard.Keys.END` | `"End"` |
+| `Cypress.Keyboard.Keys.HOME` | `"Home"` |
+| `Cypress.Keyboard.Keys.PAGEDOWN` | `"PageDown"` |
+| `Cypress.Keyboard.Keys.PAGEUP` | `"PageUp"` |
+| `Cypress.Keyboard.Keys.ENTER` | `"Enter"` |
 | `Cypress.Keyboard.Keys.TAB` | `"Tab"` |
+| `Cypress.Keyboard.Keys.BACKSPACE` | `"Backspace"` |
+| `Cypress.Keyboard.Keys.DELETE` | `"Delete"` |
+| `Cypress.Keyboard.Keys.INSERT` | `"Insert"` |
+| `Cypress.Keyboard.Keys.F1` | `"F1"` |
+| `Cypress.Keyboard.Keys.F2` | `"F2"` |
+| `Cypress.Keyboard.Keys.F3` | `"F3"` |
+| `Cypress.Keyboard.Keys.F4` | `"F4"` |
+| `Cypress.Keyboard.Keys.F5` | `"F5"` |
+| `Cypress.Keyboard.Keys.F6` | `"F6"` |
+| `Cypress.Keyboard.Keys.F7` | `"F7"` |
+| `Cypress.Keyboard.Keys.F8` | `"F8"` |
+| `Cypress.Keyboard.Keys.F9` | `"F9"` |
+| `Cypress.Keyboard.Keys.F10` | `"F10"` |
+| `Cypress.Keyboard.Keys.F11` | `"F11"` |
+| `Cypress.Keyboard.Keys.F12` | `"F12"` |
+
+:::caution
+<strong>Browser-Specific Functionality:</strong>
+In Firefox, [the F6 key is used to change focus to the next frame](https://support.mozilla.org/en-US/kb/keyboard-shortcuts-perform-firefox-tasks-quickly#w_current-page). Pressing F6 via `cy.press()` will dispatch the initial `keydown` appropriately, but due to the focus change, the `keyup` event will not be dispatched to the iframe containing the application under test.
+
+To re-focus the iframe after pressing F6, use [`cy.focus()`](/api/commands/focus).
+:::
+
+## Supported Characters
+
+Single character keys are supported, like `a`, `b`, `c`, etc. There is no need to reference `Cypress.Keyboard.Keys` record for these keys, just type them normally as a string:
+
+```javascript
+cy.get('input').focus()
+cy.press('a')
+```
+
+Multi-codepoint UTF-8 characters are also supported and do not need to be entered as individual codepoints. For example, `é` can be either one single codepoint or two separate codepoints when the accent is pressed as a subsequent modifier key. You do not need to press each codepoint separately; just type the entire character as a string.
+
+```javascript
+// works
+cy.get('input').focus()
+cy.press('é') // \u00e9 (composed é)
+cy.press('é') // \u0065\u0301 (e + combining acute accent)
+
+// also fine, but not necessary
+cy.get('input').focus()
+cy.press('e') // \u0065
+cy.press('́') // \u0301 (combining acute accent)
+```
+
+Strings with multiple characters are not supported. If you need to input longer strings into a text input or similar, use [`cy.type()`](/api/commands/type).
 
 <Icon name="angle-right" /> **options _(Object)_**
 
@@ -125,6 +179,7 @@ If your application prevents the default behavior of the `beforeunload` event, t
 | Version                             | Changes                      |
 | ----------------------------------- | ---------------------------- |
 | [14.3.0](/app/references/changelog) | Added the `.press()` command |
+| [15.1.0](/app/references/changelog) | Expanded support to include named keys and single+multi-codepoint UTF-8 characters. |
 
 ## See also