Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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-only

key 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

Fuentes