Test de clavier
Testez la fonctionnalité des touches du clavier, affichez l'état et les informations de valeur des touches en temps réel
Historique des touches
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
- Placez le curseur sur la zone de test
- Appuyez sur n'importe quelle touche du clavier
- Observez la surbrillance de la touche et le panneau d'informations
- 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
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: 0Appui 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.