Teste de teclado

Diagnóstico do teclado
ms
Atalhos reservados pelo navegador podem não ser registrados.

Use este teste de teclado para verificar se o navegador recebe cada tecla física do notebook, do teclado de mesa ou de um teclado externo USB ou Bluetooth. Pressione as teclas e veja-as acender em tempo real: a página mostra localmente o código físico event.code, o valor produzido event.key, a localização da tecla, os eventos de repetição, o pico de rollover e os avisos de tecla travada.

Como testar um teclado

  1. 1

    Escolha a visualização do layout

    Escolha ANSI, ISO ou compacto para que a grade na tela fique parecida com o teclado que você está checando. Os teclados vendidos no Brasil seguem o padrão ABNT2, com corpo ISO, tecla Enter alta, tecla Ç dedicada e uma tecla extra ao lado do Shift esquerdo. O navegador informa os códigos físicos mesmo que as teclas tenham outros caracteres impressos.

  2. 2

    Inicie o teste e pressione as teclas

    Clique em Iniciar teste, mantenha a aba em foco e pressione cada tecla. A tecla fica azul enquanto está pressionada, verde depois de solta e âmbar se continuar pressionada além do limite de aviso de tecla travada.

  3. 3

    Leia o diagnóstico

    Use o registro de eventos, o pico de rollover, o contador de repetições e a lista de teclas pressionadas para encontrar teclas sem nenhum evento, digitação que se repete sozinha, problemas com os modificadores da esquerda e da direita e combinações que o teclado não informa ao mesmo tempo.

O que um teste de teclado no navegador mostra

Os eventos de teclado nos navegadores de desktop modernos expõem dois valores úteis. event.code identifica a posição física da tecla, como KeyQ, Space, NumpadEnter ou ShiftLeft. event.key é o valor gerado pelo layout ativo, então a mesma tecla física pode devolver um caractere diferente em QWERTY, ABNT2, AZERTY, QWERTZ, Dvorak ou em outro método de entrada.

Essa diferença é o coração do diagnóstico. Se KeyQ acende mas o valor da tecla não é o esperado, a tecla física está chegando ao navegador e a diferença vem do layout ativo. Se nenhum evento aparece para uma tecla que deveria alcançar a página, o problema pode estar no hardware, no firmware, no driver do sistema operacional, no navegador ou em um atalho reservado antes que a página consiga vê-lo.

Diagnóstico O que significa Serve para
Código físico Código de posição do hardware, como KeyA ou Numpad5 Conferir qual interruptor físico foi acionado
Valor da tecla Caractere ou ação gerados pelo layout ativo Identificar diferenças de layout ou de modificadores
Localização Padrão, esquerda, direita ou teclado numérico Testar Shift, Ctrl, Alt e as teclas do bloco numérico
Pico de rollover Maior número de teclas pressionadas ao mesmo tempo na sessão Checagem rápida de limites de combinações ou ghosting
Eventos de repetição Eventos repeat enviados pelo navegador enquanto a tecla fica pressionada Achar teclas que repetem sem motivo
Aviso de tecla travada Tecla pressionada por mais tempo que o limite escolhido Flagrar teclas que não soltam corretamente

Teclado ABNT2, cedilha e teclas de acento

A grade na tela identifica as teclas pela posição física, com rótulos latinos, porque event.code descreve o lugar e não o caractere. No teclado ABNT2 a tecla Ç é dedicada e aparece com o código Semicolon, seguindo a posição de referência norte-americana. O ABNT2 ainda traz uma tecla a mais entre o Shift direito e a barra, informada como IntlRo, e o bloco numérico usa vírgula no lugar do ponto decimal, o que combina com a formatação brasileira de números.

As teclas de acento agudo, til e circunflexo são teclas mortas: elas não escrevem nada até você pressionar a vogal seguinte, e isso é normal, não indica defeito. Quem prefere o layout US Internacional obtém os acentos pelas aspas e pelo til da linha superior; em qualquer caso, mudar o layout altera apenas event.key, nunca event.code.

Rollover, ghosting e limites

Rollover é a quantidade de teclas simultâneas que um teclado consegue informar. Muitos teclados de escritório lidam bem com combinações de duas ou três teclas, enquanto teclados gamer anunciam rollover de 6 teclas ou N-key rollover. Este teste mostra os eventos que realmente chegam ao navegador, mas não pode provar teclas que o teclado, o sistema operacional ou o navegador nunca entregaram. Encare o pico de rollover como uma checagem prática numa página web, não como um certificado de laboratório.

Erros comuns

  • Mantenha a aba em foco. Trocar de aba ou abrir a barra de endereços pode interromper os eventos keyup, por isso o teste limpa a lista de teclas pressionadas quando a página perde o foco.
  • Alguns atalhos são reservados pelo navegador ou pelo sistema operacional, incluindo Alt+Tab, Cmd+Tab, Cmd+W, Cmd+L e F5.
  • Teclados de celular, teclados virtuais, composição por IME, teclas mortas e ferramentas de acessibilidade podem alterar ou atrasar o valor informado da tecla.
  • Se apenas uma tecla falhar aqui, teste em outro navegador e em outra porta USB antes de concluir que o interruptor queimou.

Perguntas frequentes

Não. Os eventos de tecla são lidos e exibidos no seu navegador. A ferramenta não envia valores de teclas, códigos físicos, dados de tempo ou histórico de eventos para nenhum servidor.

Porque event.code sempre descreve a posição física conforme o layout de referência norte-americano. No teclado ABNT2 a tecla Ç ocupa essa posição, então o código físico é Semicolon enquanto o valor da tecla event.key mostra corretamente o ç.

Navegadores e sistemas operacionais reservam certas teclas e atalhos antes que a página consiga lê-los. Combinações do sistema como Alt+Tab, Cmd+Tab, Cmd+L ou a atualização do navegador podem nunca chegar a este teste.

event.code é a posição física da tecla, enquanto event.key é o caractere ou a ação gerados pelo layout de teclado ativo. Trocar de layout muda o valor da tecla sem mudar o código físico.

O teste mostra o maior número de teclas que chegaram juntas ao navegador durante a sua sessão. Ele não certifica teclas filtradas pelo firmware do teclado, pelo sistema operacional ou pelo navegador antes de a página recebê-las.

Ferramentas relacionadas