ToolActToolAct

Test de clavier

Testez la fonctionnalité des touches du clavier, affichez l'état et les informations de valeur des touches en temps réel

Esc
F1
F2
F3
F4
F5
F6
F7
F8
F9
F10
F11
F12
`
1
2
3
4
5
6
7
8
9
0
-
=
Backspace
Tab
Q
W
E
R
T
Y
U
I
O
P
[
]
\
Caps
A
S
D
F
G
H
J
K
L
;
'
Enter
Shift
Z
X
C
V
B
N
M
,
.
/
Shift
Ctrl
Win
Alt
Space
Alt
Win
Menu
Ctrl

Historique des touches

Appuyez sur n'importe quelle touche pour commencer le test...

Qu'est-ce que le test de clavier ?

Un test de clavier vérifie si les frappes arrivent jusqu’au navigateur et comment celui-ci décrit chaque événement. Il sert lorsqu’une touche semble bloquée, qu’un raccourci ne fonctionne pas, qu’un clavier d’ordinateur portable paraît endommagé ou qu’un nouveau clavier mécanique doit être contrôlé rapidement. L’outil affiche key, code, l’ancien keyCode, la position de la touche, l’état de répétition et les modificateurs comme Ctrl, Shift, Alt ou Meta. Ces informations aident à distinguer panne matérielle, différence de disposition et comportement logiciel : une même touche physique peut produire un caractère différent selon le clavier. Les raccourcis système comme Ctrl+Alt+Del ou Alt+Tab ne parviennent généralement pas à la page, ce qui est normal.

Comment utiliser

Comment utiliser

  1. Placez le curseur sur la zone de test
  2. Appuyez sur n'importe quelle touche du clavier
  3. Observez la surbrillance de la touche et le panneau d'informations
  4. Consultez l'historique des touches ci-dessous

Conseils

  • Une surbrillance verte indique que la touche fonctionne correctement
  • Toutes les touches standard du clavier peuvent être testées
  • Détection des touches modificatrices (Ctrl, Shift, Alt, Meta)
  • Les touches répétées sont signalées dans le panneau d'informations

Cas d’utilisation

Diagnostiquer les touches bloquées ou défaillantesAppuyez sur les touches et observez le clavier virtuel s’illuminer en temps réel grâce aux événements keydown et keyup. Le panneau de la touche courante expose key, code, keyCode, which, location, l’état des modificateurs et le statut de répétition, ce qui permet de comparer une touche qui se déclenche deux fois, qui scintille ou qui ne s’enregistre qu’en fin de course avec un interrupteur connu fonctionnel avant de conclure à une panne globale du clavier.
Vérifier les modificateurs gauche/droite et le pavé numériqueComme l’outil affiche la propriété location du KeyboardEvent, il peut distinguer les positions standard, gauche, droite et pavé numérique lorsque le navigateur fournit cette information. C’est utile pour tester les flux de travail riches en raccourcis qui dépendent du Ctrl gauche vs Ctrl droit, du Alt droit pour AltGr, ou d’un Entrée du pavé numérique que le système mappe à un code scan différent du Entrée principal.
Capturer un historique court d’événements clavierLes 50 dernières pressions de touches non répétées sont conservées dans un historique visible, facilitant la comparaison entre ce que vous avez l’intention de taper et ce que le navigateur a réellement reçu. Les commandes d’effacement et de réinitialisation permettent d’effectuer des tests ciblés sans rafraîchir la page, et le journal des frappes n’est rendu que sur la page locale, de sorte que tout contenu sensible saisi reste dans cet onglet.
Vérifier le N-key rollover et l’anti-ghosting sur les claviers gamingMaintenez plusieurs touches alphabétiques enfoncées simultanément et observez le panneau des touches actives s’illuminer en temps réel. Un clavier qui n’enregistre qu’une partie des touches enfoncées échoue à la promesse d’anti-ghosting ou de N-key rollover, car l’USB HID est normalement limité à 6KRO tandis que les claviers PS/2 ou n-key rollover rapportent les 104 touches ; des lettres manquantes pendant une combinaison WASD plus Shift est le symptôme classique.
Distinguer la disposition du navigateur de la carte physique des touchesComparez la valeur de la touche affichée avec le code rapporté pour détecter les incohérences comme une disposition Dvorak produisant des codes QWERTY, ou un clavier non-US émettant toujours des valeurs centrées sur le US à partir d’une disposition obsolète du système. C’est utile pour diagnostiquer pourquoi un raccourci fonctionne dans le shell système mais pas dans une application web qui écoute code plutôt que key.

Principe technique

Le navigateur expose les événements clavier via l'interface KeyboardEvent : chaque pression déclenche un événement keydown et un événement keyup. KeyboardEvent porte plusieurs propriétés clés : key est la valeur de caractère de la touche (influencée par la disposition et l'état Shift — par ex. a vs A) ; code est l'identifiant de position physique (indépendant de la disposition — KeyA est KeyA sur QWERTY comme sur AZERTY) ; keyCode est une valeur numérique obsolète (dépréciée mais encore présente dans l'ancien code) ; location indique la position de la touche (0 standard, 1 gauche, 2 droite, 3 pavé numérique). Pour détecter les combinaisons, écouter les quatre indicateurs booléens de modificateurs ctrlKey, shiftKey, altKey, metaKey — par ex. sur Ctrl+C, ctrlKey=true et key='c'. L'ordre de déclenchement est keydown -> keypress (déprécié) -> keyup ; tant qu'une touche est maintenue, keydown continue de se déclencher et event.repeat=true. Le développement de jeux préfère code (insensible au changement de disposition par le joueur), tandis que les champs de saisie préfèrent key (qui donne le caractère réel). Le N-key rollover (NKRO) signifie que le matériel du clavier peut enregistrer un nombre quelconque de touches simultanément ; les claviers USB ordinaires sont limités à 6KRO par le protocole USB HID — au-delà de 6 touches maintenues simultanément, des événements commencent à être perdus. Les claviers mécaniques avec interfaces PS/2 ou pilotes spécialisés peuvent offrir un véritable NKRO.

  • KeyboardEvent.key est la valeur de caractère ('a'/'A'/'Enter'), influencée par la disposition et Shift — à utiliser dans les scénarios de champ de saisie.
  • KeyboardEvent.code est l'identifiant de position physique ('KeyA'/'Digit1'), indépendant de la disposition — à utiliser pour les jeux et les raccourcis.
  • Valeurs de location : 0 standard, 1 modificateur gauche, 2 modificateur droit, 3 pavé numérique — utile pour distinguer Shift, Ctrl, Alt gauche/droit.
  • Combinaisons : ctrlKey/shiftKey/altKey/metaKey sont quatre booléens indiquant l'état des modificateurs ; à combiner avec key pour détecter Ctrl+C, Cmd+Shift+P, etc.
  • event.repeat=true signifie qu'une touche maintenue se répète automatiquement ; dans les tests de pression prolongée, utilisez cet indicateur pour filtrer les événements répétés.
  • 6KRO vs NKRO : le rollover à 6 touches est une limite du protocole USB HID ; les claviers mécaniques peuvent atteindre le N-key rollover (NKRO) via PS/2 ou un pilote dédié.

Exemples

Appui sur une touche de lettre

Appuyer sur A -> key: "a", code: "KeyA", keyCode: 65, location: 0 (standard)

Appui sur une touche de fonction

Appuyer sur F1 -> key: "F1", code: "F1", keyCode: 112, location: 0

Appui sur une combinaison

Appuyer sur Ctrl+C -> détecté Ctrl (code: "ControlLeft", location: 1) + C (code: "KeyC", ctrlKey: true)

FAQ

Quelles touches le test détecte-t-il ?

Presque toutes les touches physiques pour lesquelles le navigateur reçoit un keydown : alphanumériques, modificateurs (Maj/Ctrl/Alt/Meta), flèches, touches de fonction F1-F24, pavé numérique, touches multimédias (volume, lecture) sur les navigateurs compatibles. Chaque touche pressée passe au vert sur le clavier à l'écran, ce qui vous permet de repérer les touches qui ne répondent pas.

Pourquoi ma touche Fn n'est-elle pas détectée ?

Sur la plupart des ordinateurs portables, Fn est gérée au niveau du firmware et ne produit pas d'événement clavier JavaScript — c'est normal et non un défaut. Les combinaisons de la rangée de fonctions (Fn+F5, etc.) ne produisent souvent que l'action (volume +) sans code de touche. Utilisez un clavier de bureau ou un clavier externe pour tester ces touches.

Le test fonctionne-t-il pour les touches bloquées ou qui rebondissent ?

Oui. Appuyez une fois sur une touche et observez combien d'événements keydown se déclenchent. Un switch qui rebondit envoie plusieurs événements en quelques millisecondes. Dans certaines versions, la page peut lister les horodatages bruts des événements, ce qui rend le rebond visible.

Quelle est la différence entre key, code et keyCode ?

key est la valeur (« a », « Shift », « Enter »). code est la position physique (« KeyA », « ShiftLeft ») — identique sur toutes les dispositions de clavier. keyCode est l'identifiant numérique déprécié (toujours émis pour la compatibilité). Utilisez « code » pour identifier les touches physiques indépendamment de la disposition linguistique.

Peut-on tester le n-key rollover (NKRO) ?

Partiellement. La page affiche les touches actuellement maintenues, donc vous pouvez en presser plusieurs à la fois et voir combien sont enregistrées. Les claviers USB HID et PS/2 ont des limites de ghosting différentes ; le test ici donne un résultat web réaliste, mais un testeur dédié (Aqua's KeyTest, Switch Hitter) fait davantage autorité pour des mesures sérieuses.

Les touches mortes et les compositions IME sont-elles détectées ?

La composition IME (chinois, japonais, coréen) supprime généralement les événements de touche sous-jacents pendant la composition. Désactivez l'IME et utilisez le mode de saisie directe pour tester les touches individuellement. Les touches mortes (accent aigu, tréma sur les dispositions européennes) émettent Dead suivi de la touche suivante combinée.

Quelque chose est-il envoyé à un serveur ?

Non. Les événements clavier sont traités entièrement dans votre navigateur. Rien n'est journalisé ni transmis.