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