Testador de Teclado

Sobre Testador de Teclado

Testador de Teclado ajuda a diagnosticar teclas travadas ou não responsivas sem instalar software extra. Alterne entre layouts comuns, destaque cada pressionamento de tecla e observe o registro atualizar com o código de evento exato para que você possa remapear ou substituir teclas com confiança. Experimente também Testador de Tela e Teste de Digitação.

1. Escolha o layout que combina com seu teclado (QWERTY, AZERTY, Mac ou Windows).
2. Clique na página ou pressione qualquer tecla para começar. Teclas destacam e aparecem no registro instantaneamente.
3. Use o botão "Mostrar códigos de tecla" quando precisar do nome event.code para atalhos ou remapeamento.
4. Pressione resetar para limpar o histórico de eventos e iniciar um novo teste.

Como sei se uma tecla do meu teclado está quebrada?

Pressione a tecla suspeita com a página do testador em foco. Uma tecla funcionando acende imediatamente e aparece no registro de eventos com um par 'Pressionada' / 'Solta'. Uma tecla morta não produz nada — sem destaque, sem entrada no log. Uma tecla instável só responde de vez em quando ou apenas quando pressionada com força. Se a mesma tecla falha em vários navegadores, é um defeito de hardware; se só falha em um SO, é mais provável que seja problema de driver ou remapeamento.

O que é uma tecla 'travada' e como o testador detecta?

Tecla travada é aquela que o teclado continua reportando como pressionada mesmo depois de você soltar. Pressione a tecla uma vez e olhe o painel 'Atualmente pressionadas': se a tecla continuar destacada após você soltar, ou se eventos 'Mantida' continuarem disparando sozinhos, o switch está travado mecânica ou eletricamente. Limpar com ar comprimido sob o keycap resolve a maioria dos casos; se não, o switch precisa ser trocado.

Por que algumas teclas não registram ou digitam o caractere errado?

Três causas comuns: layout errado (um teclado AZERTY francês em um SO em QWERTY — troque com o seletor 'Layout do teclado'), o SO tem um remapeamento customizado (Windows PowerToys, macOS Karabiner, Linux setxkbmap), ou um modificador confunde o navegador (algumas teclas da camada Fn nunca chegam ao SO). O botão 'Mostrar códigos de tecla' revela event.code, que é independente do layout — útil para detectar remapeamentos.

O testador detecta problemas de rollover e ghosting?

Sim — segure três teclas ou mais ao mesmo tempo. Um teclado com NKRO (N-Key Rollover) registra todas as teclas em 'Atualmente pressionadas'. Teclados baratos de membrana costumam parar em 2KRO ou 3KRO e a quarta tecla é descartada em silêncio; alguns mostram eventos 'fantasmas' onde teclas que você não apertou aparecem (comum em membranas com matriz compartilhada). Teclados mecânicos e gaming geralmente anunciam NKRO via USB, então você pode pressionar acordes inteiros sem perder teclas.

Funciona em Mac, Windows e Linux?

Sim. A página lê eventos de teclado padrão do navegador, e os três sistemas implementam isso. O layout 'MacBook QWERTY' adiciona Command (⌘) e Option (⌥), enquanto 'Windows QWERTY' inclui as teclas Win e Menu. O comportamento da linha de função depende do BIOS/SO do laptop — em muitos MacBooks você precisa segurar Fn para enviar F1–F12, a não ser que ative 'Use F1, F2, etc. keys as standard function keys'.

Por que as teclas Fn / brilho / volume não aparecem no registro?

A maioria dos atalhos da camada Fn (brilho, volume, bloqueio de tela, multimídia) é interceptada pelo firmware do teclado ou pelo SO antes de chegar ao navegador. O testador só registra o que chega ao navegador, então a ausência de teclas multimídia é o esperado, não falha. Para validá-las, use o visualizador de entradas do SO (no macOS 'Show Keyboard Viewer'). Letras, números, modificadores, setas e F1–F12 dedicadas chegam ao navegador e aparecem no registro.

É seguro — algo do que eu digito é enviado a algum lugar?

Sim. O teste inteiro roda no seu navegador usando os eventos DOM padrão 'keydown' / 'keyup'. Nada é enviado, armazenado em servidor ou persistido entre sessões. Fechar a aba apaga o registro imediatamente. Você pode rodar o testador offline (após a página carregar uma vez) sem nenhuma diferença.

Quando devo usar a visualização de códigos?

Ative 'Mostrar códigos de tecla' sempre que precisar de event.code ou event.key (ao configurar atalhos no VS Code, Vim, OBS ou lançadores de jogo). Os códigos são estáveis entre layouts — 'KeyA' é a posição física da tecla A tanto em QWERTY quanto em Dvorak — então são o que vincular aos atalhos. Se você só vê números (como 65), o navegador está reportando o deprecado keyCode; as vinculações modernas usam event.code.