feat: extend Cypress.Keyboard.Keys and cy.press to support (almost) all keyboard keys

cli/types/cypress.d.ts

@@ -684,7 +684,150 @@ declare namespace Cypress {
     Keyboard: {
       defaults(options: Partial<KeyboardDefaultsOptions>): void
       Keys: {
-        TAB: 'Tab',
+        // Numbers
+        '0': '0',
+        '1': '1',
+        '2': '2',
+        '3': '3',
+        '4': '4',
+        '5': '5',
+        '6': '6',
+        '7': '7',
+        '8': '8',
+        '9': '9',
+        // Letters
+        'a': 'a',
+        'b': 'b',
+        'c': 'c',
+        'd': 'd',
+        'e': 'e',
+        'f': 'f',
+        'g': 'g',
+        'h': 'h',
+        'i': 'i',
+        'j': 'j',
+        'k': 'k',
+        'l': 'l',
+        'm': 'm',
+        'n': 'n',
+        'o': 'o',
+        'p': 'p',
+        'q': 'q',
+        'r': 'r',
+        's': 's',
+        't': 't',
+        'u': 'u',
+        'v': 'v',
+        'w': 'w',
+        'x': 'x',
+        'y': 'y',
+        'z': 'z',
+        'A': 'A',
+        'B': 'B',
+        'C': 'C',
+        'D': 'D',
+        'E': 'E',
+        'F': 'F',
+        'G': 'G',
+        'H': 'H',
+        'I': 'I',
+        'J': 'J',
+        'K': 'K',
+        'L': 'L',
+        'M': 'M',
+        'N': 'N',
+        'O': 'O',
+        'P': 'P',
+        'Q': 'Q',
+        'R': 'R',
+        'S': 'S',
+        'T': 'T',
+        'U': 'U',
+        'V': 'V',
+        'W': 'W',
+        'X': 'X',
+        'Y': 'Y',
+        'Z': 'Z',
+        // Special characters
+        '!': '!',
+        '@': '@',
+        '#': '#',
+        '$': '$',
+        '%': '%',
+        '^': '^',
+        '&': '&',
+        '*': '*',
+        '(': '(',
+        ')': ')',
+        '-': '-',
+        '_': '_',
+        '=': '=',
+        '+': '+',
+        '[': '[',
+        ']': ']',
+        '{': '{',
+        '}': '}',
+        '\\': '\\',
+        '|': '|',
+        ';': ';',
+        ':': ':',
+        "'": "'",
+        '"': '"',
+        ',': ',',
+        '.': '.',
+        '<': '<',
+        '>': '>',
+        '/': '/',
+        '?': '?',
+        '`': '`',
+        '~': '~',
+        ' ': ' ',
+        // Control keys
+        'Enter': 'Enter',
+        'Tab': 'Tab',
+        'Backspace': 'Backspace',
+        'Delete': 'Delete',
+        'Insert': 'Insert',
+        'Home': 'Home',
+        'End': 'End',
+        'PageUp': 'PageUp',
+        'PageDown': 'PageDown',
+        'Escape': 'Escape',
+        'CapsLock': 'CapsLock',
+        'Shift': 'Shift',
+        'Control': 'Control',
+        'Alt': 'Alt',
+        'Meta': 'Meta',
+        // Arrow keys
+        'ArrowUp': 'ArrowUp',
+        'ArrowDown': 'ArrowDown',
+        'ArrowLeft': 'ArrowLeft',
+        'ArrowRight': 'ArrowRight',
+        // Function keys
+        'F1': 'F1',
+        'F2': 'F2',
+        'F3': 'F3',
+        'F4': 'F4',
+        'F5': 'F5',
+        'F6': 'F6',
+        'F7': 'F7',
+        'F8': 'F8',
+        'F9': 'F9',
+        'F10': 'F10',
+        'F11': 'F11',
+        'F12': 'F12',
+        // Media keys
+        'AudioVolumeMute': 'AudioVolumeMute',
+        'AudioVolumeDown': 'AudioVolumeDown',
+        'AudioVolumeUp': 'AudioVolumeUp',
+        'MediaTrackNext': 'MediaTrackNext',
+        'MediaTrackPrevious': 'MediaTrackPrevious',
+        'MediaStop': 'MediaStop',
+        'MediaPlayPause': 'MediaPlayPause',
+        // Other keys
+        'NumLock': 'NumLock',
+        'ScrollLock': 'ScrollLock',
+        'Pause': 'Pause',
       },
     }
 
@@ -4242,7 +4385,7 @@ declare namespace Cypress {
      */
     (chainer: 'be.NaN'): Chainable<Subject>
     /**
-     * Asserts that the target is a number or a date greater than or equal to the given number or date `start`, and less than or equal to the given number or date `finish` respectively.
+     * Asserts that the target is a number or a date greater than or equal to the given number `start`, and less than or equal to the given number or date `finish` respectively.
      * However, it's often best to assert that the target is equal to its expected value.
      * @example
      *    cy.wrap(6).should('be.within', 5, 10)

packages/driver/cypress/e2e/commands/actions/press.cy.ts

@@ -1,21 +1,58 @@
+import type { KeyPressSupportedKeys } from '@packages/types'
+
 describe('src/cy/commands/actions/press', () => {
-  it('dispatches the tab keypress to the AUT', () => {
-    // Non-BiDi firefox is not supported
-    if (Cypress.browser.family === 'firefox' && Cypress.browserMajorVersion() < 135) {
-      return
-    }
+  // Non-BiDi firefox is not supported
+  if (Cypress.browser.family === 'firefox' && Cypress.browserMajorVersion() < 135) {
+    return
+  }
 
-    // TODO: Webkit is not supported. https://github.com/cypress-io/cypress/issues/31054
-    if (Cypress.isBrowser('webkit')) {
-      return
-    }
+  // TODO: Webkit is not supported. https://github.com/cypress-io/cypress/issues/31054
+  if (Cypress.isBrowser('webkit')) {
+    return
+  }
 
+  beforeEach(() => {
     cy.visit('/fixtures/input_events.html')
+  })
 
-    cy.press(Cypress.Keyboard.Keys.TAB)
+  const testKeyPress = (key: KeyPressSupportedKeys) => {
+    it(`dispatches ${key} keypress to the AUT`, () => {
+      cy.press(key)
+      cy.get('#keydown').should('have.value', key)
+      cy.get('#keyup').should('have.value', key)
+    })
+  }
 
-    cy.get('#keydown').should('have.value', 'Tab')
+  // Numbers
+  ;['0', '1', '2', '3', '4', '5', '6', '7', '8', '9'].forEach(testKeyPress)
 
-    cy.get('#keyup').should('have.value', 'Tab')
-  })
+  // Letters
+  ;['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm',
+    'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z',
+    'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M',
+    'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'].forEach(testKeyPress)
+
+  // Special characters
+  ;['!', '@', '#', '$', '%', '^', '&', '*', '(', ')', '-', '_', '=',
+    '+', '[', ']', '{', '}', '\\', '|', ';', ':', '\'', '"', ',', '.',
+    '<', '>', '/', '?', '`', '~', ' '].forEach(testKeyPress)
+
+  // Control keys
+  ;['Enter', 'Tab', 'Backspace', 'Delete', 'Insert', 'Home', 'End',
+    'PageUp', 'PageDown', 'Escape', 'CapsLock', 'Shift', 'Control',
+    'Alt', 'Meta'].forEach(testKeyPress)
+
+  // Arrow keys
+  ;['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight'].forEach(testKeyPress)
+
+  // Function keys
+  ;['F1', 'F2', 'F3', 'F4', 'F5', 'F6', 'F7', 'F8', 'F9', 'F10', 'F11', 'F12'].forEach(testKeyPress)
+
+  // Media keys
+  ;['AudioVolumeMute', 'AudioVolumeDown', 'AudioVolumeUp',
+    'MediaTrackNext', 'MediaTrackPrevious', 'MediaStop',
+    'MediaPlayPause'].forEach(testKeyPress)
+
+  // Other keys
+  ;['NumLock', 'ScrollLock', 'Pause'].forEach(testKeyPress)
 })