CKTIS / JavaScript
Campos de KeyboardEvent: significado, posición y estado de las teclas
Distingue el valor de una tecla de su posición física y consulta la repetición, el estado de Shift y la composición de texto. Estos campos de KeyboardEvent ayudan a gestionar atajos sin confundir la distribución del teclado con el texto introducido.
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.key; event.code; event.repeat; event.shiftKey; event.isComposingKeyboardEvent describe eventos de teclado como keydown y keyup. Las cinco propiedades que se describen aquí (key, code, repeat, shiftKey e isComposing) son de solo lectura, pero algunas propiedades heredadas de Event, como cancelBubble, admiten escritura. KeyboardEvent.key es una cadena que identifica el significado de la tecla teniendo en cuenta la distribución y los modificadores, por ejemplo, "z", "Z" o "Enter". KeyboardEvent.code es una cadena que identifica la posición física de la tecla con independencia de la distribución: en un teclado QWERTZ, "KeyY" puede acompañar a key: "Z". Usa key para el significado de la tecla y code para los controles basados en la posición.
KeyboardEvent.repeat es un booleano: true indica la repetición automática de una tecla mantenida, no un recuento de repeticiones. En un controlador keydown, if (event.repeat) return; puede omitir las acciones repetidas. KeyboardEvent.shiftKey indica si Shift estaba activo cuando ocurrió el evento; no significa que el propio evento corresponda a Shift. Al pulsar una tecla Shift (keydown), el valor es true; al soltarla (keyup), puede seguir siendo true si la otra tecla Shift sigue pulsada.
KeyboardEvent.isComposing es un booleano que indica un evento ocurrido entre compositionstart y compositionend, por ejemplo, durante la composición de texto mediante una IME. Omitir los atajos cuando vale true reduce las interferencias con la composición, pero no detecta todos los casos límite de las IME: puede valer false al principio o al final de la composición. Los eventos de teclado no sustituyen al evento input para seguir los cambios de texto.
Estas son API Web del navegador, no funciones de una edición concreta de ECMAScript; Node 24 en el repositorio no demuestra que estén disponibles. Comprueba la compatibilidad de cada propiedad con los navegadores de destino; MDN marca repeat como Baseline 2025, lo que no garantiza su compatibilidad con versiones anteriores. El ejemplo crea un evento sintético con valores explícitos: comprueba el acceso a los campos, no las pulsaciones reales ni el comportamiento de una IME.
Ejemplos
(() => {
const event = new KeyboardEvent("keydown", {
key: "Z",
code: "KeyY",
repeat: true,
shiftKey: true,
isComposing: false
});
const { key, code, repeat, shiftKey, isComposing } = event;
console.log(JSON.stringify({ key, code, repeat, shiftKey, isComposing }));
})();Resultado
{"key":"Z","code":"KeyY","repeat":true,"shiftKey":true,"isComposing":false}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.