Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

KeyboardEvent: valor da tecla e repetição automática

Usa `key` para identificar o valor da tecla e `repeat` para distinguir o primeiro toque das repetições automáticas quando manténs a tecla premida.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

event.key     // string, read-only
 event.repeat  // boolean, read-only
new KeyboardEvent("keydown", { key: "Enter", repeat: true })

KeyboardEvent.key é uma propriedade só de leitura que devolve uma cadeia de caracteres como "Enter", "a" ou "A". O valor depende do esquema do teclado e dos modificadores ativos, como Shift. Ao contrário de code, que identifica a posição física da tecla, key pode mudar entre eventos se o estado de um modificador mudar.

KeyboardEvent.repeat é uma propriedade booleana só de leitura. Nos eventos keydown reais, vale false no primeiro toque e true nos eventos seguintes gerados pela repetição automática. Não indica se uma tecla está premida naquele momento. Nem todas as teclas se repetem e a frequência de repetição depende do ambiente.

Para executar uma ação uma só vez sempre que primes Enter, verifica event.key === "Enter" && !event.repeat no processador de keydown. Se a ação se deve repetir enquanto a tecla estiver premida, não filtres os eventos com base em repeat.

KeyboardEvent é uma API da plataforma Web, não faz parte do ECMAScript 2024. Não assumas que existe em todos os ambientes de execução de JavaScript; confirma o suporte no ambiente de destino.

Exemplos

{
  function handleKeydown(event) {
    if (event.key !== "Enter" || event.repeat) return;
    console.log("activate");
  }

  handleKeydown({ key: "Enter", repeat: false });
  handleKeydown({ key: "Enter", repeat: true });
  handleKeydown({ key: "Escape", repeat: false });
}

Resultado

activate

Executa o código em Node.js ou na consola do navegador. O processador recebe diretamente três objetos simples com as propriedades `key` e `repeat`, em vez de eventos de teclado. Só escreve `activate` para o primeiro objeto; o teste verifica a condição, não a frequência de repetição.

Lições relacionadas

  • JavaScript · Lição 34 · Intermédio · Versão: 3
  • JavaScript · Lição 35 · Intermédio · Versão: 3
  • JavaScript · Lição 38 · Intermédio · Versão: 3

Fontes