WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

KeyboardEvent-Felder: Tastenbedeutung, Position und Zustand

Unterscheide den Wert einer Taste von ihrer physischen Position und prüfe Wiederholung, Shift-Zustand und Texteingabe-Komposition. Diese KeyboardEvent-Felder helfen bei der Verarbeitung von Tastenkürzeln, ohne Tastaturlayout und eingegebenen Text zu verwechseln.

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; event.code; event.repeat; event.shiftKey; event.isComposing

KeyboardEvent beschreibt Tastaturereignisse wie keydown und keyup. Die fünf hier behandelten Eigenschaften (key, code, repeat, shiftKey und isComposing) sind schreibgeschützt. Einige von Event geerbte Eigenschaften wie cancelBubble sind dagegen beschreibbar. KeyboardEvent.key ist eine Zeichenfolge, die die Bedeutung der Taste unter Berücksichtigung von Layout und Modifikatoren angibt, etwa "z", "Z" oder "Enter". KeyboardEvent.code ist eine Zeichenfolge, die unabhängig vom Layout die physische Position der Taste identifiziert: Auf einer QWERTZ-Tastatur kann "KeyY" mit key: "Z" auftreten. Verwende key für die Tastenbedeutung und code für positionsbasierte Steuerung.

KeyboardEvent.repeat ist ein boolescher Wert: true bedeutet, dass eine gehaltene Taste automatisch wiederholt wird, nicht dass eine Wiederholungsanzahl angegeben ist. In einem keydown-Handler kann if (event.repeat) return; wiederholte Aktionen überspringen. KeyboardEvent.shiftKey gibt an, ob Shift zum Zeitpunkt des Ereignisses aktiv war; es bedeutet nicht, dass das Ereignis selbst Shift betrifft. Beim Drücken einer Shift-Taste (keydown) ist der Wert true; beim Loslassen (keyup) kann er weiterhin true sein, wenn die andere Shift-Taste noch gedrückt ist.

KeyboardEvent.isComposing ist ein boolescher Wert, der ein Ereignis zwischen compositionstart und compositionend kennzeichnet, zum Beispiel während der Texteingabe-Komposition mit einer IME. Werden Tastenkürzel übersprungen, wenn der Wert true ist, stört das die Komposition weniger, erfasst aber nicht alle IME-Grenzfälle: Am Anfang oder Ende der Komposition kann der Wert false sein. Tastaturereignisse ersetzen das input-Ereignis nicht, wenn Textänderungen verfolgt werden sollen.

Dies sind browserbasierte Web APIs und keine Funktionen einer bestimmten ECMAScript-Ausgabe; Node 24 im Repository belegt nicht, dass sie verfügbar sind. Prüfe die Kompatibilität jeder Eigenschaft mit den Zielbrowsern; MDN kennzeichnet repeat als Baseline 2025, was die Unterstützung in älteren Versionen nicht garantiert. Das Beispiel erstellt ein synthetisches Ereignis mit expliziten Werten: Es prüft den Zugriff auf die Felder, nicht echte Tastendrücke oder das Verhalten einer IME.

Beispiele

(() => {
  const event = new KeyboardEvent("keydown", {
    key: "Z",
    code: "KeyY",
    repeat: true,
    shiftKey: true,
    isComposing: false
  });

  const { key, code, repeat, shiftKey, isComposing } = event;
  console.log(JSON.stringify({ key, code, repeat, shiftKey, isComposing }));
})();

Ergebnis

{"key":"Z","code":"KeyY","repeat":true,"shiftKey":true,"isComposing":false}

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