WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

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

Quellen