CKTIS / JavaScript
KeyboardEvent: valor de la tecla y repetición automática
Usa `key` para identificar el valor de la tecla y `repeat` para distinguir la pulsación inicial de las repeticiones automáticas al mantenerla pulsada.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
event.key // string, read-only
event.repeat // boolean, read-only
new KeyboardEvent("keydown", { key: "Enter", repeat: true })KeyboardEvent.key es una propiedad de solo lectura cuyo valor es una cadena como "Enter", "a" o "A". Depende de la distribución del teclado y de los modificadores activos, como Shift. A diferencia de code, que identifica la posición física de la tecla, key puede cambiar entre eventos si cambia el estado de un modificador.
KeyboardEvent.repeat es una propiedad booleana de solo lectura. En los eventos keydown reales, vale false en la pulsación inicial y true en los eventos posteriores generados por la repetición automática. No indica si una tecla está pulsada en ese momento. No todas las teclas se repiten y la frecuencia de repetición depende del entorno.
Para ejecutar una acción una vez por pulsación de Intro, comprueba event.key === "Enter" && !event.repeat en el manejador de keydown. Si la acción debe repetirse mientras la tecla siga pulsada, no filtres eventos en función de repeat.
KeyboardEvent es una API de la plataforma web, no de ECMAScript 2024. No des por hecho que existe en todos los entornos de ejecución de JavaScript; comprueba la compatibilidad en el entorno de destino.
Ejemplos
{
function handleKeydown(event) {
if (event.key !== "Enter" || event.repeat) return;
console.log("activate");
}
handleKeydown({ key: "Enter", repeat: false });
handleKeydown({ key: "Enter", repeat: true });
handleKeydown({ key: "Escape", repeat: false });
}Resultado
activate
Ejecuta el código en Node.js o en la consola de un navegador. El manejador recibe directamente tres objetos simples con las propiedades `key` y `repeat` en lugar de eventos de teclado. Solo muestra `activate` para el primer objeto; se comprueba la condición, no la frecuencia de repetición.
Lecciones relacionadas
- JavaScript · Lección 34 · Intermedio · Versión: 3
- JavaScript · Lección 35 · Intermedio · Versión: 3
- JavaScript · Lección 38 · Intermedio · Versión: 3