Como o teste de teclado funciona
Cada tecla apertada manda duas informações para o navegador. KeyboardEvent.code identifica a tecla física (a que fica na posição do Q é sempre KeyQ), e KeyboardEvent.key traz o caractere que o seu layout produz. O teste desenha o teclado a partir do primeiro valor, então cada tecla é encontrada no lugar certo, seja qual for o idioma configurado no seu teclado. É por isso que dá para testar teclado ABNT2: o Ç fica na posição de Semicolon e acende normalmente.
- Laranja indica que a tecla está pressionada agora.
- Verde indica que a tecla já foi testada pelo menos uma vez.
- O contador mostra quantas teclas do teclado desenhado você já testou. O objetivo é chegar em todas.
- O painel abaixo do teclado mostra a última tecla com o caractere, o código e o antigo key code, além de um histórico dos últimos toques.
Espaço, setas, Tab e as teclas de função ficam retidos enquanto o teste está ativo, para a página não rolar nem perder o foco. Aperte Esc duas vezes para sair do teste e recuperar a navegação normal com Tab.
Escolha o layout certo
Escolha ANSI ou ISO conforme o formato do seu Enter. Para um teclado ABNT2, use ISO: ele tem o Enter em L e a tecla extra perto do Shift esquerdo. Depois escolha as legendas: QWERTY, AZERTY ou QWERTZ. As legendas mudam, o teste não: uma tecla é uma tecla. No Chrome e no Edge, a página pede ao navegador o seu layout real e usa as legendas dele quando disponíveis. Nos outros navegadores, o desenho mostra as legendas do QWERTY americano, mas a detecção continua igual.
O ABNT2 tem ainda uma tecla a mais ao lado do Shift direito (/?). Ela não está no desenho, mas aparece no histórico quando você aperta, então dá para conferir se funciona. Esconda o teclado numérico em um notebook ou em um teclado TKL, para o contador considerar só as teclas que você tem.
Como ler o resultado
| O que você vê | O que significa |
|---|---|
| Uma tecla nunca fica verde | Switch morto, solda quebrada ou sujeira embaixo da tecla. Teste em um editor de texto para descartar uma tecla de sistema. |
| Uma tecla acende sem ser tocada | Switch preso ou curto-circuito na matriz. |
| Um toque aparece duas vezes no histórico | Chatter: um switch mecânico gasto que repica. Limpe ou troque o switch. |
| Uma tecla acende outra tecla | O layout está errado no sistema operacional, ou um programa de remapeamento está ativo. |
| Várias teclas falham quando apertadas juntas | Isso é ghosting. Faça o teste ghosting teclado. |
Os limites de um teste no navegador
Uma página web só vê o que o sistema operacional repassa. A tecla Fn nunca sai do teclado. A tecla Windows ou Command, o Print Screen e algumas teclas de mídia costumam ser interceptadas ou só aparecem quando soltas. Alguns atalhos, como Alt+Tab ou Ctrl+W, agem antes que a página consiga bloqueá-los, então teste essas teclas sozinhas.
O teste não mede quantas teclas você consegue segurar ao mesmo tempo (o teste de ghosting faz isso), nem a latência do teclado. Se todas as teclas ficam verdes aqui mas uma não funciona em um jogo, confira os controles do jogo ou algum programa de macro antes de culpar o hardware.
Perguntas frequentes
Por que uma tecla não acende?
Ou a tecla está morta, ou o sistema operacional fica com ela para si. Teste em um editor de texto. Se ela digita lá mas não aqui, é uma tecla de sistema (veja os limites abaixo). Se não digita em lugar nenhum, o switch ou a matriz do teclado está com defeito.
Por que as teclas Windows e Fn não são detectadas?
A tecla Fn é tratada dentro do próprio teclado e nunca chega ao computador. A tecla Windows e alguns atalhos (Alt+Tab, Ctrl+Alt+Del) são capturados pelo sistema operacional antes do navegador, ou só aparecem pela metade. É um limite do navegador, não um defeito do seu teclado.
Funciona com teclado ABNT2, com Ç?
Sim. O teste lê a posição física de cada tecla, então funciona com qualquer layout, inclusive o ABNT2. O desenho mostra as legendas do QWERTY americano, a não ser que o Chrome ou o Edge leiam o layout real nas configurações do sistema. A tecla extra do ABNT2 ao lado do Shift direito (/?) não aparece no desenho, mas é registrada no histórico.
Qual é a diferença entre ANSI e ISO?
Os teclados ANSI, comuns nos Estados Unidos, têm um Enter largo de uma linha e um Shift esquerdo comprido. Os teclados ISO têm um Enter alto em forma de L e uma tecla a mais entre o Shift esquerdo e o Z. O ABNT2 segue o formato ISO.
O que eu digito é gravado?
Não. As teclas são lidas no seu navegador e ficam só na memória para desenhar o teclado e o histórico. Nada é salvo nem enviado, e recarregar a página apaga tudo.
Atualizado em 26 de outubro de 2026