WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

KeyboardEvent: Tastenwert und automatische Wiederholung

Mit `key` ermittelst du den Tastenwert, mit `repeat` unterscheidest du das erste Drücken von automatischen Wiederholungen beim Gedrückthalten.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

event.key     // string, read-only
 event.repeat  // boolean, read-only
new KeyboardEvent("keydown", { key: "Enter", repeat: true })

KeyboardEvent.key ist eine schreibgeschützte Eigenschaft mit einem Zeichenkettenwert wie "Enter", "a" oder "A". Der Wert hängt von der Tastaturbelegung und aktiven Modifikatortasten wie Shift ab. Anders als code, das die physische Position der Taste bezeichnet, kann sich key zwischen Ereignissen ändern, wenn sich der Zustand einer Modifikatortaste ändert.

KeyboardEvent.repeat ist eine schreibgeschützte boolesche Eigenschaft. Bei echten keydown-Ereignissen ist sie beim ersten Drücken false und bei nachfolgenden automatischen Wiederholungen true. Sie zeigt nicht an, ob eine Taste gerade gedrückt ist. Nicht alle Tasten wiederholen sich, und die Wiederholrate hängt von der Umgebung ab.

Damit eine Aktion pro Druck auf Enter nur einmal ausgeführt wird, prüfe im keydown-Handler event.key === "Enter" && !event.repeat. Soll sich die Aktion beim Gedrückthalten wiederholen, filtere Ereignisse nicht anhand von repeat.

KeyboardEvent gehört zur Webplattform und nicht zu ECMAScript 2024. Setze es nicht in jeder JavaScript-Laufzeit voraus; prüfe die Unterstützung in deiner Zielumgebung.

Beispiele

{
  function handleKeydown(event) {
    if (event.key !== "Enter" || event.repeat) return;
    console.log("activate");
  }

  handleKeydown({ key: "Enter", repeat: false });
  handleKeydown({ key: "Enter", repeat: true });
  handleKeydown({ key: "Escape", repeat: false });
}

Ergebnis

activate

Führe den Code in Node.js oder in einer Browserkonsole aus. Der Handler erhält direkt drei einfache Objekte mit `key` und `repeat` statt Tastaturereignissen. Nur beim ersten Objekt gibt er `activate` aus. Getestet wird die Bedingung, nicht die Wiederholrate.

Zugehörige Lektionen

  • JavaScript · Lektion 34 · Mittlere Stufe · Version: 3
  • JavaScript · Lektion 35 · Mittlere Stufe · Version: 3
  • JavaScript · Lektion 38 · Mittlere Stufe · Version: 3

Quellen