Descobrir o código de uma tecla (keycode)

Pressione qualquer tecla para ver o nome dela e todos os códigos que o navegador recebe.

Pressione qualquer tecla para ver os códigos dela.

Pressione qualquer tecla

event.keyO que a tecla digita ou faz
…
event.codeQual é a tecla: o lugar dela no teclado
…
event.keyCodeCódigo antigo, obsoleto, mas ainda enviado
…

Digite aqui para ver o que um teclado virtual ou um método de entrada envia.

Todos os detalhes do evento

event.which
…O mesmo número do keyCode. Também obsoleto.
event.location
…Diferencia teclas que existem em dobro: esquerda, direita ou teclado numérico.
Teclas modificadoras
…Seguradas junto com esta tecla: ctrlKey, shiftKey, altKey, metaKey.
event.repeat
…true quando a tecla fica pressionada e se repete.
event.isComposing
…true enquanto um método de entrada monta um caractere (chinês, japonês, coreano).
No seu layout
…O que esta tecla digita no layout do seu teclado, sem Shift (Keyboard Map API). Pode mostrar seu layout principal em vez do que está em uso.
getModifierState()
…Todos os modificadores e travas que o navegador informa. Desligado também pode significar que o navegador não informa essa.

Código para usar

Identificar a tecla por

A mesma tecla em todos os layouts de teclado. Melhor para jogos e atalhos.

Pressione uma tecla e o código dela aparece aqui.

Registro de eventos (nenhum evento ainda)

Os eventos aparecem aqui quando você pressiona uma tecla.

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

Comece por aqui

  1. Pressione qualquer tecla. No celular, toque primeiro na Caixa de texto.
  2. Leia o nome, o event.key, o event.code e o keyCode.
  3. Clique em Copiar ao lado de um valor, ou em Copiar código para um trecho de código.

Como ler seu resultado

O que você vê O que significa
A tecla grande A tecla que você pressionou, pelo nome, com as teclas modificadoras que segurou: Shift esquerdo, Ctrl + S, Enter (teclado numérico).
event.key O que a tecla digita ou faz: “a”, “A” com Shift, “Enter”, “ArrowUp”. Muda com o layout do teclado e com o Shift.
event.code Qual tecla ela é: o lugar dela no teclado, como “KeyA” ou “ShiftRight”. É igual em todos os layouts.
event.keyCode O número antigo da tecla, como 65 para A. É obsoleto, mas os navegadores ainda o enviam.
event.location 0 para a maioria das teclas, 1 para uma tecla da esquerda, 2 para uma da direita, 3 para o teclado numérico.
Teclas modificadoras Quais entre Ctrl, Shift, Alt e Meta (tecla Windows ou Cmd) estavam seguradas.
No seu layout O que a tecla digita no layout do seu teclado, sem Shift. Só o Chrome e o Edge no computador sabem dizer.
getModifierState() Todos os modificadores e travas que o navegador informa, como Caps Lock e Num Lock, ligados ou desligados.
Registro de eventos Todos os eventos keydown, keyup e de texto, do mais novo ao mais antigo.

Qual valor devo usar?

  • event.code para teclas que importam pelo lugar: controles de jogo (WASD), atalhos, um piano no teclado.
  • event.key para teclas que importam pelo significado: Enter, Escape, as setas ou um caractere digitado como “?”.
  • Não use keyCode nem which em código novo. Eles são obsoletos e mudam entre navegadores.

Dica: Em Código para usar, a ferramenta escreve o JavaScript da tecla que você acabou de pressionar, com as teclas modificadoras que segurou.

Tabela de códigos de tecla

Códigos de tecla em um layout de teclado dos EUA, com os nomes de tecla do Windows. Teclas de pontuação podem enviar outros números de keyCode em outros layouts.
Teclaevent.codeevent.keykeyCodekeyCode no Firefox
BackspaceBackspaceBackspace8
TabTabTab9
EnterEnterEnter13
Enter (teclado numérico)NumpadEnterEnter13
Shift esquerdoShiftLeftShift16
Shift direitoShiftRightShift16
Ctrl esquerdoControlLeftControl17
Ctrl direitoControlRightControl17
Alt esquerdoAltLeftAlt18
Alt direitoAltRightAlt18
PausePausePause19
Caps LockCapsLockCapsLock20
EscEscapeEscape27
EspaçoSpace" "32
Page UpPageUpPageUp33
Page DownPageDownPageDown34
EndEndEnd35
HomeHomeHome36
Seta para a esquerdaArrowLeftArrowLeft37
Seta para cimaArrowUpArrowUp38
Seta para a direitaArrowRightArrowRight39
Seta para baixoArrowDownArrowDown40
Print ScreenPrintScreenPrintScreen44
InsertInsertInsert45
DeleteDeleteDelete46
0 a 9Digit0 a Digit90 a 948 a 57
A a ZKeyA a KeyZa a z65 a 90
Windows esquerdoMetaLeftMeta91
MenuContextMenuContextMenu93
0 (teclado numérico) a 9 (teclado numérico)Numpad0 a Numpad90 a 996 a 105
Multiplicação (teclado numérico)NumpadMultiply*106
Mais (teclado numérico)NumpadAdd+107
Menos (teclado numérico)NumpadSubtract-109
Decimal (teclado numérico)NumpadDecimal.110
Divisão (teclado numérico)NumpadDivide/111
F1 a F12F1 a F12F1 a F12112 a 123
Num LockNumLockNumLock144
Scroll LockScrollLockScrollLock145
MudoAudioVolumeMuteAudioVolumeMute173181
Diminuir volumeAudioVolumeDownAudioVolumeDown174182
Aumentar volumeAudioVolumeUpAudioVolumeUp175183
Ponto e vírgulaSemicolon;18659
IgualEqual=18761
VírgulaComma,188
HífenMinus-189173
PontoPeriod.190
BarraSlash/191
Acento graveBackquote`192
Colchete esquerdoBracketLeft[219
Barra invertidaBackslash\220
Colchete direitoBracketRight]221
Aspas simplesQuote'222

Remapear uma tecla

Apps de remapeamento usam nomes de tecla próprios, então você não cola esses valores neles. Use o nome da tecla grande e o event.code para ter certeza de qual tecla é qual. Depois escolha a tecla no app. No Gerenciador de Teclado do PowerToys e no Karabiner-Elements, você pode pressionar a tecla para escolhê-la.

Se algo der errado

Nada aparece quando você pressiona uma tecla

Clique primeiro na caixa de teclas. As teclas pressionadas em outro ponto da página também contam, mas só enquanto a caixa de teclas está na sua tela. Teclas digitadas na busca do menu ou em outros campos não contam.

Uma tecla não mostra nada

Seu teclado ou computador reserva algumas teclas para si, então o navegador nunca as recebe. Fn, teclas de brilho e muitas teclas de mídia funcionam assim. Nenhum site consegue ver essas teclas.

No Windows, a tecla Print Screen envia só um keyup, então ela aparece quando você a solta.

Um atalho fechou a aba ou abriu uma janela

Os navegadores reservam alguns atalhos: Ctrl + N, Ctrl + T, Ctrl + W, Ctrl + Tab, Ctrl + Page Up, Ctrl + Page Down e Ctrl + 1 a Ctrl + 9 no Windows, e Cmd + N, Cmd + T, Cmd + W e Cmd + Q no Mac. O computador reserva outros, como Alt + F4, Windows + L e Ctrl + Alt + Del. A tecla Windows sozinha abre o menu Iniciar. A página nunca recebe essas teclas. Outros atalhos, como Ctrl + S ou F5, aparecem na caixa de teclas sem fazer nada.

Em um celular Android, a tecla é “Unidentified” e o keyCode é 229

O teclado virtual não diz aos sites qual tecla você tocou. Ele só envia o texto. Procure o evento input no registro de eventos: o data dele mostra o que você digitou (em uma exclusão, o data fica vazio e o inputType diz o que aconteceu). Para ver códigos de tecla reais, conecte um teclado Bluetooth ou USB.

Os iPhones costumam enviar a tecla real e o keyCode, mas o event.code costuma vir vazio.

Digitar em chinês, japonês ou coreano mostra keyCode 229

Seu método de entrada monta cada caractere com várias teclas, então as teclas mostram keyCode 229 ou key “Process”, e isComposing fica true enquanto ele trabalha. Os navegadores diferem na primeira e na última tecla. Leia o texto pronto pelo evento compositionend ou input. Mais em keyCode 229 e teclas “Unidentified”.

A tecla mostra “Dead”

É uma tecla morta: ela espera a próxima tecla para colocar um acento nela, como ´ e depois e para formar é. Layouts com acentos têm essas teclas. A caixa de teclas mostra qual é a tecla. Para ver a letra com acento, digite as duas teclas na Caixa de texto.

O AltGr também liga Ctrl e Alt

No Windows, o AltGr funciona como Ctrl e Alt juntas. O Chrome e o Edge enviam primeiro um keydown de Control esquerdo e depois Alt direito, e ctrlKey e altKey ficam true. getModifierState(“AltGraph”) também é true, mas Ctrl + Alt também pode contar como AltGr, então nem sempre dá para distinguir.

A tecla digita o caractere errado

Se o event.code está certo, mas o event.key está errado, o computador usa outro layout de teclado. Mude nas configurações de idioma ou de teclado do computador. Se o event.code também está errado, algo remapeia a tecla: um app de remapeamento ou o software do próprio teclado.

No Mac, teclas pressionadas com Cmd segurada não mostram keyup

O macOS não envia o keyup de teclas pressionadas com a Cmd segurada, então os navegadores nem sempre conseguem informá-lo.

O keyCode é diferente em outro navegador

O Firefox costuma enviar outros números para algumas teclas, como 59 para a tecla ; onde o Chrome envia 186 em um teclado dos EUA. As teclas de pontuação também mudam com o layout do teclado. Use event.code ou event.key.

Como este teste funciona

Quando você pressiona uma tecla, o navegador envia à página um evento keydown e, ao soltar, um evento keyup. A ferramenta mostra os valores exatamente como o navegador os enviou. Nada é mudado nem adivinhado, exceto o nome da tecla, que vem do event.code.

Dentro da caixa de teclas, a ferramenta impede a ação normal de cada tecla, então F5 ou Ctrl + S mostram seus códigos em vez de recarregar ou salvar. Pressione Esc e depois Tab para sair da caixa de teclas.

A caixa de texto mostra o que um teclado virtual ou um método de entrada envia. Nela o texto aparece como de costume, e o registro de eventos também lista os eventos beforeinput, input e composition.

O que a ferramenta consegue ver

  • Todas as teclas que o navegador passa à página, com todos os valores delas.
  • O que uma tecla digita no seu layout, no Chrome e no Edge no computador (Keyboard Map API). Pode mostrar seu layout principal em vez do que está em uso.

O que ela não consegue ver

  • Teclas que o teclado ou o computador reservam para si, como a Fn.
  • Atalhos que o navegador ou o computador reservam, como Ctrl + W ou Alt + F4.
  • Scan codes e códigos de tecla virtual do Windows.

Veja como testamos teclados para saber de onde vêm nossos limites e o que um navegador não mede.

Perguntas e respostas

O que é um keycode?

Um keycode diz a um site qual tecla você pressionou. O navegador o envia a cada tecla pressionada, por exemplo 13 para Enter e 65 para A.

Hoje há três valores. O event.key é o que a tecla digita ou faz. O event.code é qual tecla ela é no teclado. O event.keyCode é o número antigo, ainda enviado, mas obsoleto.

Qual é a diferença entre event.key e event.code?

O event.code nomeia o lugar da tecla no teclado, como KeyQ para a tecla à direita do Tab. Ele é igual em todos os layouts, então serve para jogos (WASD) e atalhos.

O event.key é o que a tecla digita: "q" em um teclado dos EUA, "a" em um francês, "Q" com Shift. Use-o quando o caractere importa.

O keyCode é obsoleto? O que devo usar no lugar?

Sim. keyCode, which e charCode são obsoletos. Os navegadores ainda os enviam, então códigos antigos continuam funcionando, mas os números mudam entre navegadores e layouts de teclado. Em código novo, use event.key ou event.code.

Por que recebo keyCode 229?

229 significa que um método de entrada ou o teclado virtual ficou com a tecla. Teclados Android o enviam para quase toda tecla, com event.key "Unidentified". Os iPhones costumam enviar a tecla real. A digitação em japonês, chinês e coreano o envia enquanto um caractere é montado. Em vez disso, leia o texto pelo evento input.

Que tecla estou pressionando?

Pressione-a na caixa de teclas. A tecla grande mostra o nome dela, como Alt direito ou Enter (teclado numérico). O valor de event.code ao lado nomeia a tecla exata, igual em todos os layouts de teclado.

Dá para ver o scan code de uma tecla?

Não. Os navegadores não dão aos sites o scan code nem o código de tecla virtual do Windows. No Windows, a janela Key History do AutoHotkey mostra os dois.

Este site grava o que eu digito?

Não. A página mostra as teclas que você pressiona só na sua tela. Ela não as salva nem as envia.