Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

KeyboardEvent.code — tasto fisico anziché carattere

KeyboardEvent.code identifica la posizione fisica di un tasto indipendentemente dal layout della tastiera e dai modificatori. Scopri la differenza tra code e key e quando l’inserimento di testo e le tastiere virtuali richiedono un approccio diverso.

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.code

KeyboardEvent.code è una proprietà di sola lettura che restituisce come stringa un identificatore del tasto fisico. Leggila tramite event.code, per esempio in un gestore keydown o keyup. Fa parte della Web API UI Events, non di ECMAScript in sé.

Nomi come KeyQ, Digit2 e ShiftLeft descrivono le posizioni dei tasti, non i caratteri digitati. KeyQ identifica la posizione del tasto Q nel layout statunitense, anche quando un altro layout associa a quella posizione una lettera diversa. ShiftLeft e ShiftRight distinguono i lati della tastiera.

A differenza di code, key descrive il significato del tasto tenendo conto del layout e dei modificatori. Scegli code per i controlli basati sulla posizione e key per il significato del tasto. Per osservare la modifica del testo, usa input invece di ricostruire il testo dai codici dei tasti.

Il valore predefinito di code è "". Le tastiere virtuali non hanno sempre un equivalente univoco di una posizione fisica. Prova i browser e i dispositivi di destinazione; la presenza di Node 24 non dimostra il supporto di questa API del browser.

L’esempio imposta esplicitamente code e key negli eventi sintetici. Mostra due significati diversi con lo stesso code; non verifica la mappatura di una tastiera reale né simula la pressione di un tasto fisico.

Esempi

const events = [
  new KeyboardEvent("keydown", { code: "KeyQ", key: "q" }),
  new KeyboardEvent("keydown", { code: "KeyQ", key: "Q", shiftKey: true })
];

for (const event of events) {
  console.log(`${event.code} | ${event.key} | ${event.shiftKey}`);
}

Risultato

KeyQ | q | false
KeyQ | Q | true

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