Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

KeyboardEvent.key — il significato di un tasto

KeyboardEvent.key è una proprietà di sola lettura di tipo stringa che descrive il significato di un tasto. Tiene conto del layout della tastiera e dei modificatori; a differenza di code, non descrive la posizione fisica del tasto.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

event.key

KeyboardEvent.key, letto come event.key, restituisce una stringa che descrive il significato di un tasto. Per i caratteri stampabili, tiene conto del layout della tastiera e dei modificatori, ad esempio "a" o "A". La proprietà è di sola lettura.

UI Events raggruppa i valori denominati dei tasti in diverse categorie: "Enter" figura tra i tasti associati ai caratteri di spaziatura, "Escape" tra i tasti dell’interfaccia utente e "ArrowDown" tra i tasti di navigazione. La barra spaziatrice ha il valore " ", non "Space". "Dead" identifica un tasto morto usato per comporre caratteri, mentre "Unidentified" significa che non è stato possibile identificare il tasto. I confronti tra stringhe distinguono maiuscole e minuscole.

Usa key quando conta il significato del tasto e code quando conta la sua posizione fisica. Non considerare gli eventi della tastiera una registrazione completa dell’input di testo; per la modifica del testo, valuta gli eventi beforeinput e input.

Questa è un’API Web del browser definita in UI Events, non una funzionalità di una particolare edizione di ECMAScript. La presenza di Node 24 non ne dimostra il supporto. L’esempio imposta esplicitamente key e code: il costruttore non calcola key da code o shiftKey. Verifica la lettura dei valori, non una tastiera reale; il supporto nei browser di destinazione va verificato separatamente.

Esempi

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"));

Risultato

a:KeyA
A:KeyA
Enter:Enter

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti