normalizeHotkey | TanStack Hotkeys Docs

Call Signature

function normalizeHotkey(hotkey, platform?): HotkeyChord;

function normalizeHotkey(hotkey, platform?): HotkeyChord;

Defined in: parse.ts:255

Normalizes a hotkey to its canonical string form. Accepts a chord string, a chord object, a parsed chord, or a sequence of any of these. Each sequence step is normalized, and a one-step sequence becomes its chord.

When Mod is allowed for the platform (Command on Mac without Control; Control on Windows/Linux without Meta): emits Mod, then Alt, then Shift, then the key (e.g. Mod+Shift+E, Mod+S).
Otherwise: literal modifiers in Control+Alt+Shift+Meta order, then the key.
Resolves aliases and normalizes key casing (e.g. esc → Escape, a → A).

Parameters

hotkey

AnyChord

The hotkey to normalize

platform?

Platform

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

Returns

HotkeyChord

Example

normalizeHotkey('shift+meta+e', 'mac') // 'Mod+Shift+E'
normalizeHotkey('ctrl+a', 'windows') // 'Mod+A'
normalizeHotkey({ key: 's', mod: true }) // 'Mod+S'
normalizeHotkey(['g', 'shift+g']) // ['G', 'Shift+G']
normalizeHotkey(parseKeyboardEvent(event)) // The chord the event pressed

normalizeHotkey('shift+meta+e', 'mac') // 'Mod+Shift+E'
normalizeHotkey('ctrl+a', 'windows') // 'Mod+A'
normalizeHotkey({ key: 's', mod: true }) // 'Mod+S'
normalizeHotkey(['g', 'shift+g']) // ['G', 'Shift+G']
normalizeHotkey(parseKeyboardEvent(event)) // The chord the event pressed