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
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
- Pressione qualquer tecla. No celular, toque primeiro na Caixa de texto.
- Leia o nome, o event.key, o event.code e o keyCode.
- 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
| Tecla | event.code | event.key | keyCode | keyCode no Firefox |
|---|---|---|---|---|
| Backspace | Backspace | Backspace | 8 | |
| Tab | Tab | Tab | 9 | |
| Enter | Enter | Enter | 13 | |
| Enter (teclado numérico) | NumpadEnter | Enter | 13 | |
| Shift esquerdo | ShiftLeft | Shift | 16 | |
| Shift direito | ShiftRight | Shift | 16 | |
| Ctrl esquerdo | ControlLeft | Control | 17 | |
| Ctrl direito | ControlRight | Control | 17 | |
| Alt esquerdo | AltLeft | Alt | 18 | |
| Alt direito | AltRight | Alt | 18 | |
| Pause | Pause | Pause | 19 | |
| Caps Lock | CapsLock | CapsLock | 20 | |
| Esc | Escape | Escape | 27 | |
| Espaço | Space | " " | 32 | |
| Page Up | PageUp | PageUp | 33 | |
| Page Down | PageDown | PageDown | 34 | |
| End | End | End | 35 | |
| Home | Home | Home | 36 | |
| Seta para a esquerda | ArrowLeft | ArrowLeft | 37 | |
| Seta para cima | ArrowUp | ArrowUp | 38 | |
| Seta para a direita | ArrowRight | ArrowRight | 39 | |
| Seta para baixo | ArrowDown | ArrowDown | 40 | |
| Print Screen | PrintScreen | PrintScreen | 44 | |
| Insert | Insert | Insert | 45 | |
| Delete | Delete | Delete | 46 | |
| 0 a 9 | Digit0 a Digit9 | 0 a 9 | 48 a 57 | |
| A a Z | KeyA a KeyZ | a a z | 65 a 90 | |
| Windows esquerdo | MetaLeft | Meta | 91 | |
| Menu | ContextMenu | ContextMenu | 93 | |
| 0 (teclado numérico) a 9 (teclado numérico) | Numpad0 a Numpad9 | 0 a 9 | 96 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 F12 | F1 a F12 | F1 a F12 | 112 a 123 | |
| Num Lock | NumLock | NumLock | 144 | |
| Scroll Lock | ScrollLock | ScrollLock | 145 | |
| Mudo | AudioVolumeMute | AudioVolumeMute | 173 | 181 |
| Diminuir volume | AudioVolumeDown | AudioVolumeDown | 174 | 182 |
| Aumentar volume | AudioVolumeUp | AudioVolumeUp | 175 | 183 |
| Ponto e vírgula | Semicolon | ; | 186 | 59 |
| Igual | Equal | = | 187 | 61 |
| Vírgula | Comma | , | 188 | |
| Hífen | Minus | - | 189 | 173 |
| Ponto | Period | . | 190 | |
| Barra | Slash | / | 191 | |
| Acento grave | Backquote | ` | 192 | |
| Colchete esquerdo | BracketLeft | [ | 219 | |
| Barra invertida | Backslash | \ | 220 | |
| Colchete direito | BracketRight | ] | 221 | |
| Aspas simples | Quote | ' | 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.