function matchesKeyboardEvent(
   event, 
   hotkey, 
   platform): boolean;

Defined in: match.ts:43

Checks if a KeyboardEvent matches a hotkey.

Uses the key property from KeyboardEvent for matching, with a fallback to code for letter keys, digit keys (0-9), and punctuation keys when key produces special characters (e.g., macOS Option+letter, Shift+number, or Option+punctuation). Letter keys are matched case-insensitively.

Also handles "dead key" events where event.key is 'Dead' instead of the expected character. This commonly occurs on macOS with Option+letter combinations (e.g., Option+E, Option+I, Option+U, Option+N) and on Windows/Linux with international keyboard layouts. In these cases, event.code is used to determine the physical key.

KeyboardEvent

The KeyboardEvent to check

The hotkey string or ParsedHotkey to match against

Hotkey | ParsedHotkey

The target platform for resolving 'Mod' (defaults to auto-detection)

"mac" | "windows" | "linux"

boolean

True if the event matches the hotkey

document.addEventListener('keydown', (event) => {
  if (matchesKeyboardEvent(event, 'Mod+S')) {
    event.preventDefault()
    handleSave()
  }
})