---
title: "Código da tecla Caps Lock: keyCode 20, event.key \"CapsLock\""
description: "O Caps Lock em JavaScript envia event.key e event.code \"CapsLock\" e keyCode 20. Aperte para conferir. Use getModifierState para um aviso de \"Caps Lock ligado\"."
url: https://devicetests.com/pt-br/keycode/caps-lock
language: pt-BR
---

# Código da tecla Caps Lock

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

## Todos os valores de relance

| Tecla | event.code | event.key | keyCode | event.location |
| - | - | - | - | - |
| Caps Lock | `CapsLock` | `CapsLock` | 20 | 0 (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.

## 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.

## Teclas relacionadas

- [Código da tecla Shift](https://devicetests.com/pt-br/keycode/shift)
- [Códigos das teclas de letras (A–Z)](https://devicetests.com/pt-br/keycode/letter-keys)
- [Código da tecla Control](https://devicetests.com/pt-br/keycode/control)
- [Código da tecla Meta (tecla Windows e Command)](https://devicetests.com/pt-br/keycode/meta)
- [Descobrir o código de uma tecla: pressione qualquer tecla para ver os códigos](https://devicetests.com/pt-br/keycode)
- [Todos os códigos de tecla em uma tabela](https://devicetests.com/pt-br/keycode#key-codes)
