So funktioniert es
Jeder Tastendruck löst ein keydown- und ein keyup-Ereignis nach dem W3C-Standard UI Events aus. Der Tester liest event.code, das die physische Tastenposition benennt (z. B. KeyA oder ShiftRight) – unabhängig vom Layout –, und event.key, das Zeichen oder die Funktion, die die Taste mit deinem aktuellen Layout und den Zusatztasten erzeugt.
Die Bildschirmtastatur ist ein ANSI-Layout in voller Größe mit der zusätzlichen ISO-Taste neben der linken Umschalttaste (< > |). Tasten außerhalb davon, etwa Medien- oder Sprachtasten, werden separat aufgelistet. Unterstützt der Browser die Keyboard Map API, zeigen die Buchstabentasten die Beschriftung deines Layouts (z. B. Z und Y bei QWERTZ).
event.key und event.code
Dieselbe physische Taste kann verschiedene Werte liefern. Diese Beispiele zeigen, warum beide angezeigt werden.
| Du drückst | event.key | event.code |
|---|---|---|
| A auf einem US-Layout | "a" | "KeyA" |
| A mit Umschalt | "A" | "KeyA" |
| Dieselbe Taste auf einem französischen AZERTY-Layout | "q" | "KeyA" |
| Rechte Umschalttaste | "Shift" | "ShiftRight" |
| 1 auf dem Ziffernblock (Num an) | "1" | "Numpad1" |
Ghosting und Rollover
Viele Tastaturen verdrahten Tasten in einer Matrix, daher lassen sich manche Kombinationen aus drei oder mehr Tasten nicht vollständig erkennen: Eine Taste wird nicht registriert (Blocking) oder es erscheint eine nicht gedrückte Taste (Ghosting). „Maximal gleichzeitig“ zeigt die größte Zahl gleichzeitig gemeldeter Tasten. Gaming-Tastaturen mit N-Key-Rollover melden jede Taste; USB-Tastaturen im Boot-Modus enden oft bei sechs Tasten plus Zusatztasten.
Tipps
- Eine Taste, die nie leuchtet, während andere es tun, ist wahrscheinlich defekt oder verschmutzt; eine, die bei einem Druck zweimal auslöst, prellt vielleicht.
- Teste Rollover mit den Kombinationen, die du wirklich nutzt, z. B. W A S D plus Umschalt und Leertaste in Spielen.
- Das Betriebssystem fängt manche Kürzel vor dem Browser ab; diese lassen sich hier nicht testen.
Grundlagen und Quellen
- UI Events · W3C
- UI Events: Werte von KeyboardEvent.code · W3C
- UI Events: Werte von KeyboardEvent.key · W3C
- KeyboardEvent.code · MDN Web Docs
Zuletzt geprüft am 18. Oktober 2026
Häufige Fragen
Warum leuchtet eine Taste nicht?
Entweder ist die Taste bzw. der Schalter defekt, oder die Taste erreicht den Browser nie: Fn und Systemkürzel wie Win+L oder Cmd+Tab verarbeitet das Betriebssystem. Teste die Taste in einer anderen App, um das zu unterscheiden.
Was ist der Unterschied zwischen event.key und event.code?
event.code ist die physische Position der Taste und ändert sich nicht mit dem Layout; event.key ist, was die Taste gerade eingibt, abhängig von Layout, Umschalt und anderen Zusatztasten. Auf QWERTZ liefert die Taste mit code KeyY daher key „z“.
Wie teste ich N-Key-Rollover?
Halte Tasten nacheinander gedrückt, ohne loszulassen. „Maximal gleichzeitig“ zeigt die höchste Zahl, die die Tastatur zusammen gemeldet hat. Leuchtet eine gehaltene Taste nicht, ist das Limit für diese Kombination erreicht.