CKTIS / JavaScript
KeyboardEvent.code — tecla física en lugar de carácter
KeyboardEvent.code identifica la posición física de una tecla independientemente de la distribución del teclado y de los modificadores. Aprende en qué se diferencian code y key, y cuándo la entrada de texto y los teclados virtuales requieren otro enfoque.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
event.codeKeyboardEvent.code es una propiedad de solo lectura que devuelve como cadena un identificador de tecla física. Léela mediante event.code, por ejemplo, en un controlador keydown o keyup. Forma parte de la API web UI Events, no de ECMAScript en sí.
Nombres como KeyQ, Digit2 y ShiftLeft describen posiciones de teclas, no los caracteres escritos. KeyQ identifica la posición de la Q en la distribución estadounidense, aunque otra distribución asigne una letra distinta a esa posición. ShiftLeft y ShiftRight distinguen los lados del teclado.
A diferencia de code, key describe el significado de la tecla teniendo en cuenta la distribución y los modificadores. Elige code para controles basados en la posición y key para conocer el significado de la tecla. Para observar la edición de texto, usa input en lugar de reconstruir el texto a partir de códigos de tecla.
El valor predeterminado de code es "". Los teclados virtuales no siempre tienen un equivalente inequívoco a una posición física. Prueba los navegadores y dispositivos de destino; la presencia de Node 24 no demuestra que esta API del navegador sea compatible.
El ejemplo establece explícitamente code y key en eventos sintéticos. Muestra dos significados distintos con el mismo code; no comprueba la asignación de un teclado real ni simula la pulsación de una tecla física.
Ejemplos
const events = [
new KeyboardEvent("keydown", { code: "KeyQ", key: "q" }),
new KeyboardEvent("keydown", { code: "KeyQ", key: "Q", shiftKey: true })
];
for (const event of events) {
console.log(`${event.code} | ${event.key} | ${event.shiftKey}`);
}Resultado
KeyQ | q | false KeyQ | Q | true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.