Código da tecla Enter

O Enter envia event.key "Enter" e keyCode 13. As duas teclas Enter enviam os mesmos valores; event.code e event.location as diferenciam.

Todos os valores de relance

Valores de Enter
Teclaevent.codeevent.keykeyCodeevent.location
Enter / ReturnEnterEnter130 (Padrão)
Enter (teclado numérico)NumpadEnterEnter133 (Teclado numérico)

keyCode como o Chrome e o Edge enviam no Windows. A coluna do Mac (Chrome e Safari no Mac) e a do Firefox mostram só os números diferentes; algumas teclas também mudam conforme o sistema, como diz o texto abaixo. event.which é sempre o mesmo número do keyCode. event.key vale para um layout dos EUA sem Shift.

Pressione aqui

Clique aqui e pressione Enter

Está usando só o teclado? Pressione Esc e depois Tab para sair da caixa de teclas.

Código para reagir a Enter

Recomendado: identificar por event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'Enter') {
    // Seu código aqui
  }
});
Identificar pelo lugar da tecla: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Enter') {
    // Seu código aqui
  }
});
Código antigo que ainda usa keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 13) {
    // Seu código aqui
  }
});

Qual valor usar

Confira event.key === 'Enter'. É igual para a tecla Enter principal e a do teclado numérico, em todos os layouts, e também nos teclados de celular que enviam um Enter de verdade.

Use event.code só quando as duas teclas precisam fazer coisas diferentes: Enter é a tecla grande e NumpadEnter é a do teclado numérico. A tecla return do Mac é a mesma tecla: ela também envia Enter.

O keyCode 13 ainda chega em todos os navegadores, então o código antigo continua funcionando, mas ele é obsoleto.

O que costuma dar errado

O Enter envia a mensagem enquanto alguém ainda digita em japonês, chinês ou coreano

Com um método de entrada, o Enter primeiro confirma o caractere que está sendo formado. Seu tratador de keydown também vê esse Enter. Ignore-o enquanto um caractere está sendo composto:

if (event.isComposing || event.keyCode === 229) return;

Confira os dois: o Safari envia o Enter de confirmação com isComposing false, mas keyCode 229.

Apertar o Enter num campo de texto envia o formulário

Esse é o envio implícito do navegador. Chame event.preventDefault() no tratador de keydown se o Enter deve fazer outra coisa, ou escute o evento submit do formulário em vez da tecla, que também pega o botão Ir dos teclados de celular.

O tratador roda duas vezes ou muitas vezes

Segurar o Enter repete o keydown. Ignore as repetições com if (event.repeat) return; quando o Enter inicia algo que deve acontecer uma vez só, como enviar uma mensagem.

keypress ou keyup não se comporta como keydown

O keypress é obsoleto e dispara só para teclas que digitam algo. Ele ainda dispara para o Enter, mas não construa nada em cima dele. O keyup vem depois de o navegador já ter enviado o formulário ou adicionado a nova linha, tarde demais para impedir. Use keydown.

O Enter no celular mostra “Ir”, “Avançar” ou “Enviar”

O texto é você quem define: adicione enterkeyhint="send" (ou go, next, search, done) ao campo. Os teclados Android enviam a maioria das teclas como keyCode 229, mas o Enter em geral chega como um Enter de verdade com keyCode 13.

Shift+Enter e Ctrl+Enter

Caixas de chat em geral enviam com o Enter e adicionam uma nova linha com Shift + Enter: confira event.shiftKey. Ctrl + Enter (Cmd + Enter no Mac) é o atalho comum de “enviar mesmo assim”: confira event.ctrlKey || event.metaKey. Num <textarea>, o Enter adiciona uma nova linha, a não ser que você chame preventDefault().