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

CKTIS / JavaScript

KeyboardEvent.key — el significado de una tecla

KeyboardEvent.key es una propiedad de solo lectura de tipo cadena que describe el significado de una tecla. Tiene en cuenta la distribución del teclado y los modificadores; a diferencia de code, no describe la posición física de la tecla.

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

KeyboardEvent.key, leído como event.key, devuelve una cadena que describe el significado de una tecla. Para los caracteres imprimibles, tiene en cuenta la distribución del teclado y los modificadores, por ejemplo "a" o "A". La propiedad es de solo lectura.

UI Events agrupa los valores con nombre de las teclas en varias categorías: "Enter" figura entre las teclas asociadas a los caracteres de espacio en blanco, "Escape" entre las teclas de interfaz de usuario y "ArrowDown" entre las teclas de navegación. La barra espaciadora tiene el valor " ", no "Space". "Dead" identifica una tecla muerta que se usa para componer caracteres, mientras que "Unidentified" significa que no se pudo identificar la tecla. Las comparaciones de cadenas distinguen entre mayúsculas y minúsculas.

Usa key cuando importe el significado de la tecla y code cuando importe su posición física. No consideres los eventos de teclado un registro completo de la entrada de texto; para la edición, considera los eventos beforeinput e input.

Esta es una API web del navegador definida en UI Events, no una característica de una edición concreta de ECMAScript. Tener Node 24 no demuestra que sea compatible. El ejemplo establece explícitamente key y code: el constructor no calcula key a partir de code ni de shiftKey. Comprueba el acceso a los valores, no un teclado real; la compatibilidad en los navegadores de destino debe comprobarse por separado.

Ejemplos

const events = [
  new KeyboardEvent("keydown", { key: "a", code: "KeyA" }),
  new KeyboardEvent("keydown", { key: "A", code: "KeyA", shiftKey: true }),
  new KeyboardEvent("keydown", { key: "Enter", code: "Enter" })
];

console.log(events.map(event => `${event.key}:${event.code}`).join("\n"));

Resultado

a:KeyA
A:KeyA
Enter:Enter

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.

Fuentes