Tastatur-Ereignisprotokoll.
Ein Diagnose-Dashboard, das rohe Tastatur-Ereignisse des Browsers anzeigt. Nützlich für Entwickler, die Event-Handler debuggen oder bestimmte Tasteneigenschaften prüfen.
Echtzeit-Ereignisse
| Ereignis | Key | Code | KeyCode | Position | Modifikatoren | Zeitstempel |
|---|---|---|---|---|---|---|
| Noch keine Tastatur-Ereignisse protokolliert. Fokussiere den Erfassungsbereich und drücke ein paar Tasten. | ||||||
Prüfe dies, bevor du protokollierst
- Fokussiere das ErfassungsfeldKlicke es an oder drücke zuerst Tab — es werden keine Ereignisse protokolliert, bevor es fokussiert ist.
- Leere das Protokoll zwischen TestsSetze das Protokoll vor jeder neuen Taste zurück, damit Prüfungen auf doppelte Ereignisse leicht lesbar bleiben.
- Beobachte die ZeitstempelZwei keydown-Ereignisse, die nur Millisekunden auseinanderliegen und von einem einzigen Antippen stammen, deuten auf einen prellenden Switch hin, nicht auf einen Fehler.
Wie das Ereignisprotokoll funktioniert
- 1
Fokussiere den Erfassungsbereich. Klicke auf das Feld oben oder drücke Tab, um es zu fokussieren. Der Statustext ändert sich und zeigt an, dass er auf Tastatur-Ereignisse wartet.
- 2
Drücke beliebige Tasten. Jedes keydown- und keyup-Ereignis wird mit seinen rohen Eigenschaften protokolliert — key, code, keyCode, location, Modifikatoren und Zeitstempel. Die Tabelle aktualisiert sich in Echtzeit, neue Ereignisse werden oben eingefügt.
- 3
Verwalte dein Protokoll. Nutze den Button „Protokolle leeren", um die Tabelle zurückzusetzen, oder „Als CSV exportieren", um alle Ereignisse zur Analyse in einer Tabellenkalkulation oder einem Debugging-Tool herunterzuladen.
Tastatur-Ereigniseigenschaften verstehen
key ist das tatsächliche Zeichen, das die Taste erzeugt (z. B. "a", "A", "1"). Es ändert sich je nach Tastaturlayout und danach, ob Modifikatoren (Shift, Alt) aktiv sind. Auf einer französischen AZERTY-Tastatur erzeugt die äußerste linke Buchstabentaste "a" statt "q".
code ist die physische Taste, unabhängig vom Layout (z. B. "KeyA", "Digit1", "Enter"). Das Drücken derselben physischen Taste liefert immer denselben code, unabhängig von Layout oder Modifikatoren.
keyCode ist ein veralteter numerischer Code (z. B. 65 für A) aus der Zeit vor den modernen key- und code-Eigenschaften. Er gilt heute als deprecated, weil er zwischen Browsern uneinheitlich war und bei internationalen Tastaturen und Sondertasten unzuverlässig funktionierte. Verwende stattdessen code oder key.
location unterscheidet zwischen doppelt vorhandenen Tasten auf deiner Tastatur. Standardtasten melden location 0; linke Modifikatoren (Shift, Ctrl, Alt) melden 1; rechte Modifikatoren melden 2; Numpad-Tasten melden 3. Das Protokoll zeigt diese als verständliche Bezeichnungen an: "Standard", "Left (Mod)", "Right (Mod)", "Numpad".
Modifikator-Flags sind boolesche Eigenschaften — ctrlKey, shiftKey, altKey, metaKey — die angeben, ob Ctrl, Shift, Alt oder Command/Windows während des Ereignisses gehalten wurde. Sie kombinieren sich frei: Das Drücken von Ctrl+Shift+A setzt sowohl ctrlKey als auch shiftKey auf true.
repeat ist true, wenn eine gehaltene Taste wiederholte keydown-Ereignisse auslöst (Auto-Repeat). Das erste keydown hat repeat: false; hältst du die Taste weiter gedrückt, haben nachfolgende keydowns repeat: true. Dieses Protokoll zeigt nur keydown und keyup an, sodass du sich wiederholende Tasten an gehäuften identischen Einträgen erkennen kannst.
Für wen das Ereignisprotokoll gedacht ist
Tasten-Handler debuggen
Webentwickler, die eigene Tastatur-Interaktionen bauen, können genau sehen, welche Ereignisse in welcher Reihenfolge ausgelöst werden, und die vollständigen Eigenschaften des Ereignisobjekts prüfen, um sicherzustellen, dass Handler korrekt auf die Tasten reagieren, die deine Nutzer drücken.
Key Chatter erkennen
Ein defekter Switch registriert manchmal zwei keydown-Ereignisse bei einem einzigen Druck (Chatter). Beobachte die Zeitstempel, um schnelle Duplikate zu erkennen und sie auf eine einzelne physische Taste zurückzuführen — ein Zeichen für Hardwareverschleiß oder einen Switch, der Aufmerksamkeit braucht.
Unbekannte Tasten identifizieren
Eine Taste auf deiner Tastatur mit einer unbekannten Beschriftung oder einem Mediensymbol gefunden? Drücke sie hier und lies ihre code- und key-Eigenschaften, um zu verstehen, welches Ereignis sie auslöst, oder um sie in deiner Anwendung oder deinem Gaming-Setup zuzuordnen.
Remapping und Modifikatoren überprüfen
Teste Tastatur-Remapping-Software oder Tastenkombinationen auf Betriebssystemebene, indem du Ereignisse protokollierst und bestätigst, dass gedrückte Tasten die erwarteten code- und Modifikator-Kombinationen erzeugen. Prüfe, ob AltGr und andere internationale Modifikatoren korrekt registrieren.
Tastatur-Ereignis-Glossar
key- Das Zeichen, das durch den Tastendruck erzeugt wird, beeinflusst von Tastaturlayout und Modifikatoren — z. B. "a", "A", "1", "!", "é".
code- Die physische Tastenposition, unabhängig vom Layout — z. B. "KeyA", "Digit1", "Enter", "Space", immer gleich, unabhängig von Layout oder Modifikatoren.
keyCode(veraltet)- Ein veralteter numerischer Code (z. B. 65 für A). Verwende ihn nicht in neuem Code — er ist zwischen Browsern uneinheitlich und funktioniert bei internationalen Tastaturen nicht zuverlässig.
location- Die physische Position der Taste: 0 = Standard, 1 = linker Modifikator, 2 = rechter Modifikator, 3 = Numpad. Unterscheidet linke Shift-Taste von rechter Shift-Taste sowie Numpad-Tasten von regulären Tasten.
repeat- Boolesches Flag, das true ist, wenn eine gehaltene Taste ein sich wiederholendes keydown-Ereignis auslöst (Auto-Repeat). Das erste keydown ist false; nachfolgende sind true, solange die Taste gedrückt bleibt.
- Modifikator-Flags (
ctrlKey,shiftKey,altKey,metaKey) - Boolesche Flags, die angeben, ob Ctrl, Shift, Alt oder Command/Windows während des Ereignisses gehalten wurde. Bei Tastenkombinationen können mehrere Flags gleichzeitig true sein.
Tastatur-Ereignisprotokoll-FAQ
Was ist der Unterschied zwischen key und code?
key ist das tatsächliche Zeichen, das die Tastatur erzeugt (z. B. 'a', 'A', '1', '!'), abhängig von deinem Tastaturlayout und davon, ob Modifikatoren wie Shift gehalten werden. code ist die physische Position der Taste (z. B. 'KeyA', 'Digit1'), unabhängig von Layout und Modifikatoren — das Drücken derselben physischen Taste in unterschiedlichen Regionen liefert immer denselben code. Bei internationalen Tastaturen bleibt code konstant, während sich key ändert.
Was ist keyCode und warum ist es deprecated?
keyCode ist ein veralteter numerischer Code, der jeder Taste zugewiesen ist (z. B. 65 für die A-Taste). Er wurde vor den modernen key- und code-Eigenschaften verwendet und gilt als deprecated, weil er zwischen Browsern uneinheitlich war und bei internationalen Tastaturen oder Sondertasten nicht zuverlässig funktioniert. Verwende stattdessen code für die physische Tastenposition und key für das erzeugte Zeichen.
Wie erkenne ich Key Chatter (eine Taste, die doppelt registriert)?
Key Chatter tritt auf, wenn ein einzelner Tastendruck zwei oder mehr keydown-Ereignisse ohne dazwischenliegendes keyup erzeugt. Prüfe das Protokoll auf schnelle doppelte keydown-Einträge mit demselben code und einem sehr geringen Zeitunterschied (meist unter 50ms). Wenn eine Taste durchgehend chattert, könnte das ein Hardwareproblem mit diesem Switch sein. Manche Tastaturen oder Treiber lassen sich zum Entprellen konfigurieren; sieh in der Firmware oder Software deiner Tastatur nach.
Speichert oder lädt das Protokoll meine Tastenanschläge hoch?
Nein. Die gesamte Protokollierung erfolgt vollständig in deinem Browser. Nichts, was du tippst, wird an einen Server gesendet, hochgeladen, gespeichert oder außerhalb deines Geräts irgendwo protokolliert. Ein Neuladen der Seite löscht das Protokoll vollständig. Dieses Protokoll ist ein Diagnosewerkzeug für Entwickler — deine Privatsphäre und Daten werden nicht übertragen.
Warum erscheinen manche Tasten — etwa Fn oder Medientasten — nicht im Protokoll?
Tasten wie Fn und viele dedizierte Medien-, Lautstärke- oder Helligkeitstasten werden von der Firmware der Tastatur oder vom Betriebssystem verarbeitet, bevor der Browser überhaupt ein Ereignis sieht — es gibt also nichts, was der Logger aufzeichnen könnte. Das ist erwartet, kein Fehler. Eine Standardtaste, die hier weiterhin kein keydown erzeugt — nachdem du das Erfassungsfeld angeklickt und fokussiert hast —, deutet stattdessen auf einen defekten Schalter oder eine unterbrochene Verbindung hin.