Código da tecla Meta (tecla Windows e Command)

A tecla Windows e a Cmd enviam event.key "Meta". O keyCode é 91 na tecla esquerda, mas a tecla direita e o Firefox no Mac são diferentes.

Todos os valores de relance

Valores de Tecla Windows / Command (Meta)
Teclaevent.codeevent.keykeyCodekeyCode no Macevent.location
Windows esquerdo / Command esquerdoMetaLeftMeta911 (Lado esquerdo)
Windows direito / Command direitoMetaRightMeta92932 (Lado direito)

keyCode como o Chrome e o Edge enviam no Windows. A coluna do Mac (Chrome e Safari no Mac) e a do Firefox mostram só os números diferentes; algumas teclas também mudam conforme o sistema, como diz o texto abaixo. event.which é sempre o mesmo número do keyCode. event.key vale para um layout dos EUA sem Shift.

Pressione aqui

Clique aqui e pressione a tecla Windows ou Cmd

Está usando só o teclado? Pressione Esc e depois Tab para sair da caixa de teclas.

Código para reagir a Windows esquerdo

Recomendado: identificar por event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'Meta') {
    // Seu código aqui
  }
});
Identificar pelo lugar da tecla: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'MetaLeft') {
    // Seu código aqui
  }
});
Código antigo que ainda usa keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 91) {
    // Seu código aqui
  }
});

Qual valor usar

Para atalhos no Mac, verifique event.metaKey no keydown da outra tecla. Ele é verdadeiro enquanto a Cmd (ou a tecla Windows) está pressionada. Combine com ctrlKey para atalhos que devem funcionar nos dois sistemas.

Para reagir à própria tecla, verifique event.key === 'Meta' ou event.code: MetaLeft ou MetaRight. Os mesmos nomes valem para a tecla Windows, para a tecla command do Mac e para a tecla Super do Linux.

Não use keyCode para essa tecla. A tecla esquerda é 91, mas o Firefox no Mac envia 224 para as duas, o Firefox no Windows e no Linux envia 91 para as duas, e a tecla direita é 92 no Windows e 93 no Chrome e no Safari do Mac.

O que costuma dar errado

No Mac, o keyup nunca chega para teclas apertadas com a Cmd pressionada

O macOS não envia o keyup das teclas apertadas enquanto a Cmd está pressionada: aperte Cmd + K, solte o K, e a página não recebe o keyup do K. Os navegadores não conseguem corrigir isso por completo, porque o macOS não informa a liberação. Não acompanhe o estado das teclas pressionadas durante atalhos com Cmd. Quando o keyup da Meta chegar, marque como soltas as teclas apertadas enquanto a Cmd estava pressionada.

O keyCode 93 significa duas teclas diferentes

No Windows, 93 é a tecla de menu (event.code “ContextMenu”). No Chrome e no Safari do Mac, 93 é a tecla Cmd direita. Use event.code para saber qual delas chegou.

A tecla Windows abre o menu Iniciar

A tecla Windows sozinha abre o Iniciar, e atalhos do Windows como Windows + D, Windows + L ou Windows + Tab vão para o sistema. A página não pode impedi-los. O Iniciar fica com o foco, então keyups podem se perder: zere as teclas pressionadas no evento blur da janela. Não crie atalhos com a tecla Windows.

Versões antigas do Firefox enviam “OS” e “OSLeft”

O Firefox anterior à versão 118 enviava event.key “OS” para a tecla Windows e event.code “OSLeft” e “OSRight”. O Chrome usava “OSLeft” e “OSRight” antes da versão 52. Os navegadores atuais enviam "Meta", "MetaLeft" e "MetaRight". Verifique os nomes antigos só se você der suporte a essas versões.

Atalhos com Cmd no Mac

Usuários de Mac esperam a Cmd onde o Windows usa Ctrl: Cmd + S para salvar, Cmd + Z para desfazer, Cmd + Shift + Z para refazer. Aceite event.ctrlKey || event.metaKey e escreva o atalho como Cmd + S ou ⌘S no Mac. Cmd + N, Cmd + T, Cmd + W e Cmd + Q pertencem ao navegador e nunca chegam à página.