CKTIS / JavaScript
KeyboardEvent.code — physische Taste statt Zeichen
KeyboardEvent.code identifiziert die physische Position einer Taste unabhängig von Tastaturlayout und Modifikatoren. Erfahre, wie sich code von key unterscheidet und wann Texteingabe und virtuelle Tastaturen einen anderen Ansatz erfordern.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.codeKeyboardEvent.code ist eine schreibgeschützte Eigenschaft, die eine physische Taste durch eine Zeichenfolge identifiziert. Lies sie über event.code aus, zum Beispiel in einem keydown- oder keyup-Handler. Sie gehört zur UI-Events-Web-API, nicht zu ECMAScript selbst.
Namen wie KeyQ, Digit2 und ShiftLeft beschreiben Tastenpositionen, keine eingegebenen Zeichen. KeyQ bezeichnet die Position der Q-Taste im US-Layout, auch wenn ihr ein anderes Layout einen anderen Buchstaben zuordnet. ShiftLeft und ShiftRight unterscheiden die Seiten der Tastatur.
Im Gegensatz zu code beschreibt key die Bedeutung der Taste unter Berücksichtigung von Layout und Modifikatoren. Verwende code für positionsbasierte Steuerungen und key für die Bedeutung einer Taste. Um Texteingaben zu beobachten, verwende input, statt Text aus Tastencodes nachzubilden.
Der Standardwert von code ist "". Virtuelle Tastaturen haben nicht immer ein eindeutiges Gegenstück zu einer physischen Tastenposition. Teste die Zielbrowser und -geräte; dass Node 24 vorhanden ist, belegt nicht die Unterstützung dieser Browser-API.
Das Beispiel setzt code und key in synthetischen Ereignissen ausdrücklich. Es zeigt zwei unterschiedliche Bedeutungen mit demselben code; es prüft weder die Zuordnung einer echten Tastatur noch simuliert es einen physischen Tastendruck.
Beispiele
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}`);
}Ergebnis
KeyQ | q | false KeyQ | Q | true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.