WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

KeyboardEvent.key — die Bedeutung einer Taste

KeyboardEvent.key ist eine schreibgeschützte Zeichenfolgen-Eigenschaft, die die Bedeutung einer Taste beschreibt. Sie berücksichtigt Tastaturlayout und Modifikatoren; anders als code beschreibt sie nicht die physische Position der Taste.

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

KeyboardEvent.key, ausgelesen als event.key, gibt eine Zeichenfolge zurück, die die Bedeutung einer Taste beschreibt. Bei druckbaren Zeichen berücksichtigt sie Tastaturlayout und Modifikatoren, zum Beispiel "a" oder "A". Die Eigenschaft ist schreibgeschützt.

UI Events ordnet benannte Tastenwerte verschiedenen Kategorien zu: "Enter" gehört zu den Tasten für Leerraumzeichen, "Escape" zu den Tasten für die Benutzeroberfläche und "ArrowDown" zu den Navigationstasten. Die Leertaste hat den Wert " ", nicht "Space". "Dead" bezeichnet eine tote Taste, mit der Zeichen zusammengesetzt werden, während "Unidentified" bedeutet, dass die Taste nicht erkannt werden konnte. Zeichenfolgenvergleiche unterscheiden Groß- und Kleinschreibung.

Verwende key, wenn die Bedeutung der Taste wichtig ist, und code, wenn es auf ihre physische Position ankommt. Betrachte Tastaturereignisse nicht als vollständige Aufzeichnung der Texteingabe; für die Bearbeitung kommen die Ereignisse beforeinput und input infrage.

Dies ist eine Browser-Web-API, die in UI Events definiert ist, und keine Funktion einer bestimmten ECMAScript-Ausgabe. Dass Node 24 vorhanden ist, belegt keine Unterstützung. Im Beispiel werden key und code ausdrücklich festgelegt: Der Konstruktor berechnet key nicht aus code oder shiftKey. Es prüft das Auslesen von Werten, nicht eine echte Tastatur; die Unterstützung in den Zielbrowsern muss separat geprüft werden.

Beispiele

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

Ergebnis

a:KeyA
A:KeyA
Enter:Enter

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