Journal des Événements Clavier.
Un tableau de bord de diagnostic affichant les événements clavier bruts du navigateur. Utile pour les développeurs qui déboguent des gestionnaires d'événements ou vérifient des propriétés de touches spécifiques.
Événements en Temps Réel
| Événement | Key | Code | KeyCode | Location | Modificateurs | Horodatage |
|---|---|---|---|---|---|---|
| Aucun événement clavier enregistré pour le moment. Ciblez la zone de capture et appuyez sur quelques touches. | ||||||
Vérifiez ces points avant d'enregistrer
- Donnez le focus à la zone de captureCliquez dessus ou appuyez d'abord sur Tab — aucun événement n'est enregistré tant qu'elle n'a pas le focus.
- Effacez entre chaque testRéinitialisez le journal avant chaque nouvelle touche pour que les vérifications d'événements dupliqués restent faciles à lire.
- Surveillez les horodatagesDeux keydown espacés de quelques millisecondes pour une seule frappe trahissent un switch qui fait du chatter, pas une erreur.
Comment fonctionne le journal des événements
- 1
Donnez le focus à la zone de capture. Cliquez sur la zone ci-dessus ou appuyez sur Tab pour lui donner le focus. Le texte de statut change pour indiquer qu'elle écoute les événements clavier.
- 2
Appuyez sur n'importe quelle touche. Chaque événement keydown et keyup est enregistré avec ses propriétés brutes — key, code, keyCode, location, modificateurs et horodatage. Le tableau se met à jour en temps réel, les nouveaux événements étant ajoutés en haut.
- 3
Gérez votre journal. Utilisez le bouton « Effacer les Journaux » pour réinitialiser le tableau, ou « Exporter en CSV » pour télécharger tous les événements et les analyser dans un tableur ou un outil de débogage.
Comprendre les propriétés des événements clavier
key est le caractère réel que produit la touche (par ex., "a", "A", "1"). Il change selon la disposition du clavier et si des modificateurs (Shift, Alt) sont actifs. Sur un clavier français AZERTY, la touche lettre la plus à gauche produit "a" au lieu de "q".
code est la touche physique, indépendante de la disposition (par ex., "KeyA", "Digit1", "Enter"). Appuyer sur la même touche physique renvoie toujours le même code, quelle que soit la disposition ou les modificateurs.
keyCode est un code numérique hérité (par ex., 65 pour A) datant d'avant les propriétés modernes key et code. Il est désormais déprécié car il était incohérent selon les navigateurs et peu fiable pour les claviers internationaux et les touches spéciales. Utilisez plutôt code ou key.
location distingue les touches en double sur votre clavier. Les touches standards rapportent location 0 ; les modificateurs gauches (Shift, Ctrl, Alt) rapportent 1 ; les modificateurs droits rapportent 2 ; les touches du pavé numérique rapportent 3. Le journal affiche ces valeurs sous forme d'étiquettes conviviales : « Standard », « Gauche (Mod) », « Droite (Mod) », « Pavé Numérique ».
Les indicateurs de modificateurs sont des propriétés booléennes — ctrlKey, shiftKey, altKey, metaKey — qui indiquent si Ctrl, Shift, Alt ou Command/Windows était maintenu pendant l'événement. Elles se combinent librement : appuyer sur Ctrl+Shift+A met à la fois ctrlKey et shiftKey à true.
repeat est true lorsqu'une touche maintenue déclenche des événements keydown répétés (auto-répétition). Le premier keydown a repeat: false ; si vous maintenez la touche, les keydowns suivants ont repeat: true. Ce journal affiche uniquement keydown et keyup, vous pouvez donc repérer les touches en répétition en observant des entrées identiques regroupées.
À qui s'adresse le journal des événements
Déboguer des gestionnaires de touches
Les développeurs web qui créent des interactions clavier personnalisées peuvent voir exactement quels événements se déclenchent et dans quel ordre, et inspecter toutes les propriétés de l'objet événement pour s'assurer que les gestionnaires répondent correctement aux touches pressées par leurs utilisateurs.
Détecter le chatter de touche
Un switch défaillant enregistre parfois deux événements keydown pour une seule pression (chatter). Observez les horodatages et vous pourrez repérer des doublons rapides et les rattacher à une seule touche physique — un signe d'usure matérielle ou d'un switch nécessitant de l'attention.
Identifier des touches inconnues
Vous avez trouvé une touche sur votre clavier avec une étiquette ou un symbole multimédia inconnu ? Appuyez dessus ici et lisez ses propriétés code et key pour comprendre quel événement elle déclenche, ou pour la mapper dans votre application ou votre configuration de jeu.
Vérifier le remapping et les modificateurs
Testez un logiciel de remapping clavier ou des raccourcis au niveau du système d'exploitation en enregistrant les événements et en confirmant que les touches pressées produisent les combinaisons de code et de modificateurs attendues. Vérifiez qu'AltGr et les autres modificateurs internationaux s'enregistrent correctement.
Glossaire des événements clavier
key- Le caractère produit par la pression de touche, influencé par la disposition du clavier et les modificateurs — par ex., "a", "A", "1", "!", "é".
code- L'emplacement physique de la touche, indépendant de la disposition — par ex., "KeyA", "Digit1", "Enter", "Space", toujours identique quelle que soit la disposition ou les modificateurs.
keyCode(déprécié)- Un code numérique hérité (par ex., 65 pour A). Ne l'utilisez pas dans du nouveau code — il est incohérent selon les navigateurs et ne fonctionne pas de façon fiable avec les claviers internationaux.
location- La position physique de la touche : 0 = standard, 1 = modificateur gauche, 2 = modificateur droit, 3 = pavé numérique. Distingue le Shift gauche du Shift droit, et les touches du pavé numérique des touches normales.
repeat- Indicateur booléen qui est true lorsqu'une touche maintenue déclenche un événement keydown répété (auto-répétition). Le premier keydown est false ; les suivants sont true si la touche reste pressée.
- Indicateurs de modificateurs (
ctrlKey,shiftKey,altKey,metaKey) - Des indicateurs booléens précisant si Ctrl, Shift, Alt ou Command/Windows était maintenu pendant l'événement. Plusieurs indicateurs peuvent être true simultanément pour les combinaisons de touches.
FAQ du journal des événements clavier
Quelle est la différence entre key et code ?
key est le caractère réel produit par le clavier (par ex., 'a', 'A', '1', '!'), qui dépend de la disposition de votre clavier et du maintien de modificateurs comme Shift. code est l'emplacement physique de la touche (par ex., 'KeyA', 'Digit1'), indépendant de la disposition et des modificateurs — appuyer sur la même touche physique dans différentes régions renvoie toujours le même code. Pour les claviers internationaux, code reste constant tandis que key change.
Qu'est-ce que keyCode et pourquoi est-il déprécié ?
keyCode est un code numérique hérité attribué à chaque touche (par ex., 65 pour la touche A). Il était utilisé avant les propriétés modernes key et code et est déprécié car il était incohérent selon les navigateurs et ne fonctionne pas de façon fiable avec les claviers internationaux ou les touches spéciales. Utilisez plutôt code pour l'emplacement physique de la touche et key pour le caractère produit.
Comment détecter le chatter de touche (une touche qui s'enregistre deux fois) ?
Le chatter de touche se produit lorsqu'une seule pression produit deux événements keydown ou plus sans keyup intermédiaire. Vérifiez dans le journal la présence d'entrées keydown dupliquées rapidement avec le même code et un écart de temps très faible (généralement moins de 50ms). Si une touche fait du chatter de façon constante, il peut s'agir d'un problème matériel avec ce switch. Certains claviers ou pilotes peuvent être configurés pour l'anti-rebond ; consultez le firmware ou le logiciel de votre clavier.
Le journal enregistre-t-il ou envoie-t-il mes frappes ?
Non. Tout l'enregistrement se fait entièrement dans votre navigateur. Rien de ce que vous tapez n'est envoyé à un serveur, téléchargé, stocké ou enregistré où que ce soit en dehors de votre appareil. Actualiser la page efface complètement le journal. Ce journal est un outil de diagnostic pour les développeurs — votre confidentialité et vos données ne sont pas transmises.
Pourquoi certaines touches — comme Fn ou les touches multimédias — n'apparaissent-elles pas dans le journal ?
Des touches comme Fn et de nombreuses touches dédiées au multimédia, au volume ou à la luminosité sont gérées par le micrologiciel du clavier ou par le système d'exploitation avant même que le navigateur ne voie un événement : il n'y a donc rien à enregistrer pour le journal. C'est normal, pas un défaut. Une touche standard qui ne produit toujours aucun keydown ici — après avoir cliqué sur la zone de capture pour la sélectionner — indique plutôt un interrupteur mort ou une connexion coupée.