Código da tecla Caps Lock

O Caps Lock envia event.key "CapsLock", event.code "CapsLock" e keyCode 20.

Todos os valores de relance

Valores de Caps Lock
Teclaevent.codeevent.keykeyCodeevent.location
Caps LockCapsLockCapsLock200 (Padrão)

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 Caps Lock

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

Código para reagir a Caps Lock

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

Qual valor usar

Para saber se o Caps Lock está ligado, não observe a tecla. Pergunte a qualquer evento de tecla ou de mouse: event.getModifierState('CapsLock') é true enquanto ele está ligado. Isso funciona mesmo que o Caps Lock tenha sido ligado antes de a página carregar.

Para reagir à própria tecla, confira event.key === 'CapsLock' (event.code é igual). O keyCode é 20, mas é obsoleto.

O Caps Lock muda o event.key das letras (“A” em vez de “a”), mas não muda o event.code nem o keyCode.

O que costuma dar errado

Meu aviso de “Caps Lock ligado” está errado

Contar os toques no Caps Lock dá errado se ele já estava ligado antes de a página abrir. Em vez disso, leia o estado de cada evento do campo de senha:

function checkCaps(event) {
  warning.hidden = !event.getModifierState('CapsLock');
}
password.addEventListener('keydown', checkCaps);
password.addEventListener('keyup', checkCaps);

Esconda o aviso no blur. O estado só é conhecido quando a pessoa aperta uma tecla ou mexe o mouse: não há como perguntar quando a página carrega.

No Mac, o Caps Lock envia só um evento

No Windows e no Linux, o Caps Lock envia keydown e keyup como qualquer tecla. No Mac, o Chrome e o Safari enviam só um keydown quando ele liga e só um keyup quando ele desliga. O Firefox no Mac envia só um keydown a cada vez. Por isso o aviso acima escuta os dois.

O estado no evento do próprio Caps Lock está desatualizado

Durante o evento do próprio Caps Lock, os navegadores diferem sobre se o getModifierState já mostra o novo estado. Confira de novo na tecla seguinte, ou no keyup.

Um toque rápido não liga o Caps Lock (Mac)

O macOS ignora um toque muito curto no Caps Lock, então uma tecla roçada não o liga. Sua página pode ver o evento enquanto a luz continua apagada. Confie no getModifierState, não na contagem de eventos.

Celulares nunca dizem que o Caps Lock está ligado

Os teclados na tela têm o próprio caps lock (toque duas vezes no Shift). Ele não envia eventos de Caps Lock, e getModifierState('CapsLock') continua false. Só um teclado físico informa isso.

Caps Lock em jogos e atalhos

Não use o Caps Lock como tecla para segurar: no Mac você não recebe o keyup enquanto ele está apertado. Algumas pessoas também o remapeiam para Ctrl ou Esc, e então a página recebe essa tecla. O Safari no Mac já mostra o próprio símbolo de Caps Lock nos campos de senha, então seu aviso pode aparecer duas vezes ali.