Cómo funciona
Cada pulsación genera un evento keydown y otro keyup definidos por la norma UI Events del W3C. El comprobador lee event.code, que nombra la posición física de la tecla (por ejemplo KeyA o ShiftRight) sea cual sea tu distribución, y event.key, el carácter o la función que esa tecla produce con tu distribución y modificadores actuales.
El teclado en pantalla es una distribución ANSI completa con la tecla ISO adicional junto al Mayús izquierdo. Las teclas fuera de ella, como las multimedia o de idioma, se listan aparte. Si el navegador admite la Keyboard Map API, las letras muestran las etiquetas de tu distribución (por ejemplo la Ñ).
event.key y event.code
La misma tecla física puede dar valores distintos. Estos ejemplos muestran por qué se informan ambos.
| Pulsas | event.key | event.code |
|---|---|---|
| A en una distribución de EE. UU. | "a" | "KeyA" |
| A con Mayús | "A" | "KeyA" |
| La misma tecla en una distribución francesa AZERTY | "q" | "KeyA" |
| Mayús derecho | "Shift" | "ShiftRight" |
| 1 del teclado numérico (Bloq Num activo) | "1" | "Numpad1" |
Ghosting y rollover
Muchos teclados conectan las teclas en una matriz, así que algunas combinaciones de tres o más no se detectan todas: una tecla puede no registrarse (bloqueo) o aparecer una que no pulsaste (ghosting). «Máximo a la vez» muestra el mayor número de teclas que este teclado informó pulsadas juntas. Los teclados gaming con n-key rollover informan de todas; los teclados USB en modo de arranque suelen quedarse en seis teclas más los modificadores.
Consejos
- Una tecla que nunca se ilumina mientras las demás sí probablemente está averiada o sucia; una que se activa dos veces con una sola pulsación puede tener rebote.
- Prueba el rollover con las combinaciones que de verdad usas, por ejemplo W A S D más Mayús y Espacio en juegos.
- El sistema operativo captura algunos atajos antes que el navegador, así que no se pueden probar aquí.
Criterios y fuentes
- UI Events · W3C
- UI Events: valores de KeyboardEvent.code · W3C
- UI Events: valores de KeyboardEvent.key · W3C
- KeyboardEvent.code · MDN Web Docs
Última revisión 18 de octubre de 2026
Preguntas frecuentes
¿Por qué una tecla no se ilumina?
O la tecla o su interruptor fallan, o la tecla nunca llega al navegador: Fn y los atajos del sistema como Win+L o Cmd+Tab los gestiona el sistema operativo. Prueba la tecla en otra aplicación para distinguirlo.
¿Qué diferencia hay entre event.key y event.code?
event.code es la posición física de la tecla y no cambia con la distribución; event.key es lo que la tecla escribe en ese momento, que depende de la distribución, de Mayús y de otros modificadores.
¿Cómo pruebo el n-key rollover?
Mantén pulsadas teclas una tras otra sin soltarlas. «Máximo a la vez» muestra el mayor número que el teclado informó juntas. Si una tecla que mantienes no se ilumina, el teclado ha llegado a su límite para esa combinación.