CKTIS / JavaScript
KeyboardEvent: valor de la tecla y estado de Mayús
`key` indica el valor de la tecla y `shiftKey` señala si Mayús estaba activa cuando se produjo el evento. Usa ambas propiedades para distinguir Intro de Mayús+Intro.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
event.key // string, read-only
event.shiftKey // boolean, read-onlykey y shiftKey son dos propiedades de solo lectura de una instancia de KeyboardEvent. event.key es una cadena: contiene la representación textual de una tecla imprimible o un valor predefinido, como "Enter", para una tecla especial. En los eventos generados por el navegador, la distribución del teclado y los modificadores activos influyen en key. Si importa la posición física de la tecla, usa event.code en su lugar.
event.shiftKey es un booleano: true si Mayús estaba activa cuando se produjo el evento y false en caso contrario. Describe ese evento, no el estado actual del teclado. No confundas event.key === "Shift", que identifica la propia tecla Mayús, con event.shiftKey, que puede ser true para otra tecla.
En un manejador de keydown, event.key === "Enter" && event.shiftKey detecta Intro con Mayús activa. La condición no excluye otros modificadores. KeyboardEvent es una API web, no forma parte de ECMAScript 2024; su disponibilidad depende del entorno de ejecución.
Ejemplos
{
const eventInits = [
{ key: "Enter" },
{ key: "Enter", shiftKey: true },
];
// Without KeyboardEvent, use plain objects to model just these two properties.
const events = eventInits.map((init) =>
typeof KeyboardEvent === "function"
? new KeyboardEvent("keydown", init)
: { key: init.key, shiftKey: init.shiftKey ?? false }
);
for (const event of events) {
const isShiftEnter = event.key === "Enter" && event.shiftKey;
console.log(`${event.key} | shiftKey=${event.shiftKey} | match=${isShiftEnter}`);
}
}Resultado
Enter | shiftKey=false | match=false Enter | shiftKey=true | match=true
Ejecuta el código en la consola de desarrollador del navegador o como script en Node.js. En el navegador crea dos eventos sintéticos `KeyboardEvent` sin despacharlos. Si el constructor no está disponible, usa objetos simples que solo reproducen `key` y `shiftKey`. En ambos objetos, `key` vale `"Enter"`. En el primero se omite `shiftKey` en las opciones, por lo que vale `false`; en el segundo se establece en `true`. Solo el segundo objeto cumple la condición.
Lecciones relacionadas
- JavaScript · Lección 40 · Intermedio · Versión: 3