WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

KeyboardEvent: Tastenwert und Zustand der Umschalttaste

`key` liefert den Tastenwert, während `shiftKey` angibt, ob die Umschalttaste beim Ereignis aktiv war. Mit beiden Eigenschaften kannst du Enter von Shift+Enter unterscheiden.

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

Syntax

event.key      // string, read-only
 event.shiftKey // boolean, read-only

key und shiftKey sind zwei schreibgeschützte Eigenschaften einer KeyboardEvent-Instanz. event.key ist eine Zeichenkette: Sie enthält die Textdarstellung einer druckbaren Taste oder einen vordefinierten Wert wie "Enter" für eine Sondertaste. Bei vom Browser erzeugten Ereignissen beeinflussen die Tastaturbelegung und aktive Modifikatortasten den Wert von key. Wenn die physische Tastenposition zählt, verwende stattdessen event.code.

event.shiftKey ist ein boolescher Wert: true, wenn die Umschalttaste beim Ereignis aktiv war, andernfalls false. Der Wert beschreibt dieses Ereignis, nicht den aktuellen Zustand der Tastatur. event.key === "Shift" erkennt die Umschalttaste selbst; event.shiftKey kann dagegen auch bei einer anderen Taste true sein.

In einem keydown-Handler erkennt event.key === "Enter" && event.shiftKey Enter bei aktiver Umschalttaste. Andere Modifikatortasten werden dadurch nicht ausgeschlossen. KeyboardEvent ist eine Web-API und kein Teil von ECMAScript 2024; die Verfügbarkeit hängt von der Laufzeitumgebung ab.

Beispiele

{
  const eventInits = [
    { key: "Enter" },
    { key: "Enter", shiftKey: true },
  ];

  // Without KeyboardEvent, use plain objects to model just these two properties.
  const events = eventInits.map((init) =>
    typeof KeyboardEvent === "function"
      ? new KeyboardEvent("keydown", init)
      : { key: init.key, shiftKey: init.shiftKey ?? false }
  );

  for (const event of events) {
    const isShiftEnter = event.key === "Enter" && event.shiftKey;
    console.log(`${event.key} | shiftKey=${event.shiftKey} | match=${isShiftEnter}`);
  }
}

Ergebnis

Enter | shiftKey=false | match=false
Enter | shiftKey=true | match=true

Führe den Code in der Entwicklerkonsole eines Browsers oder als Skript in Node.js aus. Im Browser erzeugt der Code zwei synthetische `KeyboardEvent`-Instanzen, ohne sie zu dispatchen. Ist der Konstruktor nicht verfügbar, verwendet der Code einfache Objekte, die nur `key` und `shiftKey` nachbilden. Bei beiden Objekten ist `key` auf `"Enter"` gesetzt. Beim ersten fehlt `shiftKey` in den Optionen und erhält daher den Wert `false`; beim zweiten ist es auf `true` gesetzt. Nur das zweite Objekt erfüllt die Bedingung.

Zugehörige Lektionen

  • JavaScript · Lektion 40 · Mittlere Stufe · Version: 3

Quellen