Docs
CodeRabbit
Cloudflare
AG Grid
SerpAPI
Netlify
OpenRouter
Neon
WorkOS
Clerk
Electric
PowerSync
Sentry
Railway
Prisma
Strapi
Unkey
CodeRabbit
Cloudflare
AG Grid
SerpAPI
Netlify
OpenRouter
Neon
WorkOS
Clerk
Electric
PowerSync
Sentry
Railway
Prisma
Strapi
Unkey
API Reference
Hotkeys API Reference
Hotkey Sequence API Reference
Key hold & held keys API Reference
Hotkey Recorder API Reference
Hotkey Sequence Recorder API Reference
Normalization & format API Reference
Normalization & format API Reference

normalizeHotkey

Function: normalizeHotkey()

ts
function normalizeHotkey(hotkey, platform): Hotkey;

Defined in: parse.ts:197

Normalizes a hotkey string to its canonical form.

  • 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. escEscape, aA).

Parameters

hotkey

The hotkey string to normalize

Key | string & object

platform

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

"mac" | "windows" | "linux"

Returns

Hotkey

The normalized hotkey string

Example

ts
normalizeHotkey('shift+meta+e', 'mac') // 'Mod+Shift+E'
normalizeHotkey('ctrl+a', 'windows') // 'Mod+A'
normalizeHotkey('esc') // 'Escape'