Código de la tecla Bloq Mayús (Caps Lock)

Caps Lock (Bloq Mayús) envía event.key "CapsLock", event.code "CapsLock" y keyCode 20.

Todos los valores de un vistazo

Valores de Bloq Mayús
Teclaevent.codeevent.keykeyCodeevent.location
Bloq MayúsCapsLockCapsLock200 (Normal)

keyCode tal como lo envían Chrome y Edge en Windows. La columna de Mac (Chrome y Safari en un Mac) y la de Firefox solo muestran los números que cambian; algunas teclas también cambian según el sistema, como explica el texto de abajo. event.which es siempre el mismo número que keyCode. event.key corresponde a un teclado inglés (US) sin pulsar Mayús.

Púlsala aquí

Haz clic aquí y pulsa Bloq Mayús

¿Usas solo el teclado? Pulsa Esc y luego Tab para salir del cuadro de teclas.

Código para reaccionar a Bloq Mayús

Recomendado: reconocer por event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'CapsLock') {
    // Tu código aquí
  }
});
Reconocer el lugar de la tecla: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'CapsLock') {
    // Tu código aquí
  }
});
Código antiguo que aún usa keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 20) {
    // Tu código aquí
  }
});

Qué valor usar

Para saber si Caps Lock está activada, no vigiles la tecla. Pregunta a cualquier evento de tecla o de ratón: event.getModifierState('CapsLock') es true mientras está activada. Funciona incluso si Caps Lock se activó antes de cargar la página.

Para reaccionar a la propia tecla, comprueba event.key === 'CapsLock' (event.code es igual). keyCode es 20, pero está obsoleto.

Caps Lock cambia event.key en las letras (“A” en vez de “a”), pero no event.code ni keyCode.

Qué suele salir mal

Mi aviso de “Bloq Mayús activado” se equivoca

Contar las pulsaciones de Caps Lock falla en cuanto estaba activada antes de abrir la página. Lee mejor el estado de cada evento del campo de contraseña:

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

Oculta el aviso en blur. El estado solo se conoce cuando la persona pulsa una tecla o mueve el ratón; no hay manera de preguntarlo al cargar la página.

En un Mac, Caps Lock envía un solo evento

En Windows y Linux, Caps Lock envía keydown y keyup como cualquier tecla. En un Mac, Chrome y Safari envían solo un keydown cuando se activa y solo un keyup cuando se desactiva. Firefox en un Mac envía solo un keydown cada vez. Por eso el aviso de arriba escucha los dos.

El evento de Bloq Mayús puede mostrar el estado anterior

Durante el evento de Caps Lock, los navegadores no coinciden en si getModifierState ya muestra el estado nuevo. Vuelve a comprobarlo en la tecla siguiente o en keyup.

Una pulsación rápida no la activa (Mac)

macOS ignora una pulsación muy corta de Caps Lock, así que rozar la tecla no la activa. Tu página puede ver el evento mientras la luz sigue apagada. Fíate de getModifierState, no del número de eventos.

Los móviles nunca dicen que Caps Lock está activada

Los teclados de pantalla tienen su propio bloqueo de mayúsculas (toca Shift dos veces). No envía eventos de Caps Lock, y getModifierState('CapsLock') se queda en false. Solo lo indica un teclado físico.

Caps Lock en juegos y atajos

No uses Caps Lock como tecla que se mantiene pulsada: en un Mac no recibirás un keyup mientras está pulsada. Algunas personas también la reasignan a Ctrl o Esc, y entonces la página recibe esa otra tecla. Safari en un Mac ya muestra su propio símbolo de Caps Lock en los campos de contraseña, así que tu aviso puede salir dos veces ahí.