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.

Qual a precisão do teste de NKRO / rollover no navegador?

Trate como dica, não como veredito de hardware. O testador só conta quantos eventos keydown o navegador realmente recebe, e esse caminho já está limitado e distorcido antes de chegar à página: o SO intercepta combinações de atalho, o firmware do teclado e a camada Fn engolem combinações em silêncio, e o ghosting de modificadores descarta teclas. Por isso um teclado NKRO real pode reportar a menos (parecendo 2-3KRO) e uma sequência de segurar-e-tocar pode contar a mais. Para uma avaliação definitiva consulte a ficha do fabricante ou um analisador USB-HID dedicado — use este teste para comparar teclas e detectar quedas óbvias.

O que é o relatório de cobertura aprovado/reprovado e o que significam as colunas CSV/JSON?

O rastreador de cobertura transforma a ferramenta em um teste de aceitação repetível: cada tecla que você pressiona pelo menos uma vez fica verde e permanece verde, um selo mostra 'X / N testadas' e uma lista de 'Teclas não testadas' diz exatamente o que falta em um teclado de mais de 100 teclas para você não se perder. Exporte o relatório completo da sessão em CSV ou JSON — cada linha é uma tecla com: código (event.code, p. ex. KeyA), rótulo, testada (sim/não), pressionamentos (total de keydown na sessão) e travada (sim quando a tecla ficou pressionada além do limite do vigia sem receber keyup). Uma linha de resumo registra o layout, o NKRO máximo e testadas/total. Anexe o arquivo a um chamado de reparo como evidência auditável.

Funciona offline e é seguro digitar senhas no testador?

É seguro e privado. Todo o teste roda localmente no seu navegador usando eventos DOM keydown/keyup padrão — nada do que você digita é registrado em servidor, enviado ou persistido entre sessões, então não há keylogging. Ainda assim, um testador de teclado não precisa da sua senha real: digite teclas aleatórias para verificar os switches. A página funciona totalmente offline depois de carregada uma vez, e fechar a aba apaga o registro imediatamente.

Como encontro o scan code / event.code de uma tecla online?

Ative 'Mostrar códigos de tecla' e pressione a tecla — cada evento registra tanto event.code quanto event.key. event.code é a posição física e independe do layout ('KeyA' é a posição do A em QWERTY, AZERTY ou Dvorak), então é o que vincular aos atalhos. event.key é o caractere produzido ('a', 'A', '@') e muda com layout e modificadores. O antigo keyCode numérico (p. ex. 65) está obsoleto; vinculações modernas usam event.code. O relatório exportado lista o event.code de cada tecla do seu layout.

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.