Code d’une touche (keycode)

Appuyez sur une touche pour voir son nom et tous les codes que reçoit votre navigateur.

Appuyez sur une touche pour voir ses codes.

Appuyez sur une touche

event.keyCe que la touche écrit ou fait
…
event.codeQuelle touche c’est : sa place sur le clavier
…
event.keyCodeAncien code, obsolète mais toujours envoyé
…

Écrivez ici pour voir ce qu’envoie un clavier à l’écran ou une méthode de saisie.

Tous les détails de l’événement

event.which
…Le même nombre que keyCode. Lui aussi est obsolète.
event.location
…Distingue les touches en double : gauche, droite ou pavé numérique.
Touches de modification
…Maintenues pendant cette touche : ctrlKey, shiftKey, altKey, metaKey.
event.repeat
…true quand la touche est maintenue et se répète.
event.isComposing
…true pendant qu’une méthode de saisie compose un caractère (chinois, japonais, coréen).
Sur votre disposition
…Ce que cette touche écrit sur la disposition de votre clavier, sans Maj (Keyboard Map API). Il peut afficher votre disposition principale plutôt que celle utilisée.
getModifierState()
…Chaque touche de modification et de verrouillage signalée par le navigateur. Désactivé peut aussi signifier que le navigateur ne signale pas celle-ci.

Code à utiliser

Reconnaître la touche par

Même touche sur toutes les dispositions de clavier. Idéal pour les jeux et les raccourcis.

Appuyez sur une touche et son code s’affiche ici.

Journal des événements (aucun événement)

Les événements s’affichent ici quand vous appuyez sur une touche.

Vous n’utilisez que le clavier ? Appuyez sur Échap, puis sur Tab, pour quitter la zone de touche.

Démarrage rapide

  1. Appuyez sur une touche. Sur un téléphone, touchez d’abord la Zone de texte.
  2. Lisez son nom, event.key, event.code et keyCode.
  3. Appuyez sur Copier à côté d’une valeur, ou sur Copier le code pour un extrait.

Comment lire vos résultats

Ce que vous voyez Ce que cela signifie
La grande touche La touche pressée, par son nom, avec les touches de modification maintenues : Maj gauche, Ctrl + S, Pavé num. Entrée.
event.key Ce que la touche écrit ou fait : « a », « A » avec Maj, « Enter », « ArrowUp ». Il change avec la disposition de votre clavier et avec Maj.
event.code Quelle touche c’est : sa place sur le clavier, comme « KeyA » ou « ShiftRight ». Il est le même sur toutes les dispositions.
event.keyCode L’ancien nombre de la touche, comme 65 pour A. Il est obsolète, mais les navigateurs l’envoient toujours.
event.location 0 pour la plupart des touches, 1 pour une touche gauche, 2 pour une touche droite, 3 pour le pavé numérique.
Touches de modification Lesquelles parmi Ctrl, Maj, Alt et Meta (touche Windows ou Commande) étaient maintenues.
Sur votre disposition Ce que la touche écrit sur la disposition de votre clavier, sans Maj. Seuls Chrome et Edge sur ordinateur peuvent le dire.
getModifierState() Chaque touche de modification et de verrouillage signalée par le navigateur, comme Verr. maj et Verr. num, activée ou désactivée.
Journal des événements Chaque événement keydown, keyup et de texte, du plus récent au plus ancien.

Quelle valeur utiliser ?

  • event.code pour les touches qui comptent par leur place : commandes de jeu (WASD), raccourcis, un piano sur le clavier.
  • event.key pour les touches qui comptent par leur sens : Entrée, Échap, les flèches, ou un caractère écrit comme « ? ».
  • Pas keyCode ni which dans du nouveau code. Ils sont obsolètes et diffèrent selon les navigateurs.

Astuce : sous Code à utiliser, l’outil écrit le JavaScript de la touche que vous venez de presser, avec les touches de modification maintenues.

Tableau des codes de touches

Codes de touches sur une disposition de clavier américaine, avec les noms de touches de Windows. Les touches de ponctuation peuvent envoyer d’autres numéros keyCode sur d’autres dispositions.
Toucheevent.codeevent.keykeyCodekeyCode dans Firefox
Retour arrièreBackspaceBackspace8
TabTabTab9
EntréeEnterEnter13
Pavé num. EntréeNumpadEnterEnter13
Maj gaucheShiftLeftShift16
Maj droiteShiftRightShift16
Ctrl gaucheControlLeftControl17
Ctrl droiteControlRightControl17
Alt gaucheAltLeftAlt18
Alt GrAltRightAlt18
PausePausePause19
Verr. majCapsLockCapsLock20
ÉchapEscapeEscape27
EspaceSpace" "32
Page précédentePageUpPageUp33
Page suivantePageDownPageDown34
FinEndEnd35
DébutHomeHome36
Flèche gaucheArrowLeftArrowLeft37
Flèche hautArrowUpArrowUp38
Flèche droiteArrowRightArrowRight39
Flèche basArrowDownArrowDown40
Impr. écranPrintScreenPrintScreen44
InserInsertInsert45
SupprDeleteDelete46
0 à 9Digit0 à Digit90 à 948 à 57
A à ZKeyA à KeyZa à z65 à 90
Windows gaucheMetaLeftMeta91
MenuContextMenuContextMenu93
Pavé num. 0 à Pavé num. 9Numpad0 à Numpad90 à 996 à 105
Pavé num. multiplierNumpadMultiply*106
Pavé num. plusNumpadAdd+107
Pavé num. moinsNumpadSubtract-109
Pavé num. décimaleNumpadDecimal.110
Pavé num. diviserNumpadDivide/111
F1 à F12F1 à F12F1 à F12112 à 123
Verr. numNumLockNumLock144
Arrêt défilScrollLockScrollLock145
MuetAudioVolumeMuteAudioVolumeMute173181
Baisser le volumeAudioVolumeDownAudioVolumeDown174182
Augmenter le volumeAudioVolumeUpAudioVolumeUp175183
Point-virguleSemicolon;18659
ÉgalEqual=18761
VirguleComma,188
MoinsMinus-189173
PointPeriod.190
Barre obliqueSlash/191
Accent graveBackquote`192
Crochet gaucheBracketLeft[219
Barre oblique inverseBackslash\220
Crochet droitBracketRight]221
ApostropheQuote'222

Remapper une touche

Les applications de remappage utilisent leurs propres noms de touches, donc inutile d’y coller ces valeurs. Utilisez le nom de la grande touche et event.code pour savoir avec certitude de quelle touche il s’agit. Choisissez ensuite la touche dans l’application. Dans PowerToys Keyboard Manager et Karabiner-Elements, vous pouvez appuyer sur la touche pour la choisir.

Si quelque chose ne va pas

Rien ne s’affiche quand vous appuyez sur une touche

Cliquez d’abord sur la zone de touche. Les touches comptent aussi depuis la page elle-même, mais seulement tant que la zone de touche est à l’écran. Les touches écrites dans la recherche du menu ou dans d’autres champs ne comptent pas.

Une touche n’affiche rien du tout

Votre clavier ou votre ordinateur garde certaines touches pour lui, donc le navigateur ne les reçoit jamais. Fn, les touches de luminosité et beaucoup de touches multimédia fonctionnent ainsi. Aucun site web ne peut voir ces touches.

Sous Windows, Impr. écran n’envoie qu’un keyup, donc elle s’affiche quand vous la relâchez.

Un raccourci a fermé l’onglet ou ouvert une fenêtre

Les navigateurs gardent certains raccourcis : Ctrl + N, Ctrl + T, Ctrl + W, Ctrl + Tab, Ctrl + Page précédente, Ctrl + Page suivante et Ctrl + 1 à Ctrl + 9 sous Windows, et Commande + N, Commande + T, Commande + W et Commande + Q sur un Mac. Votre ordinateur en garde d’autres, comme Alt + F4, Windows + L et Ctrl + Alt + Suppr. La touche Windows seule ouvre le menu Démarrer. La page ne reçoit jamais ces touches. D’autres raccourcis, comme Ctrl + S ou F5, s’affichent dans la zone de touche sans rien faire.

Sur un téléphone Android, la touche est « Unidentified » et keyCode vaut 229

Le clavier de votre écran ne dit pas aux sites web sur quelle touche vous avez appuyé. Il n’envoie que le texte. Cherchez l’événement input dans le journal des événements : sa propriété data montre ce que vous avez écrit (pour une suppression, data est vide et inputType dit ce qui s’est passé). Pour voir de vrais codes de touches, connectez un clavier Bluetooth ou USB.

Les iPhone envoient en général la vraie touche et son keyCode, mais event.code est souvent vide.

Écrire en chinois, japonais ou coréen affiche keyCode 229

Votre méthode de saisie construit chaque caractère à partir de plusieurs touches, donc les touches affichent keyCode 229 ou key « Process », et isComposing vaut true pendant ce temps. Les navigateurs diffèrent pour la première et la dernière touche. Lisez le texte terminé dans l’événement compositionend ou input. Plus de détails dans keyCode 229 et touches « Unidentified ».

La touche affiche « Dead »

C’est une touche morte : elle attend la touche suivante pour y mettre un accent, comme ^ puis e pour ê. Les dispositions avec accents en ont. La zone de touche montre de quelle touche il s’agit. Pour voir la lettre accentuée, écrivez les deux touches dans la Zone de texte.

Alt Gr active aussi Ctrl et Alt

Sous Windows, Alt Gr fonctionne comme Ctrl et Alt ensemble. Chrome et Edge envoient d’abord un keydown de Ctrl gauche, puis d’Alt droite, et ctrlKey et altKey valent tous deux true. getModifierState(“AltGraph”) vaut true aussi, mais Ctrl + Alt peut aussi compter comme Alt Gr, donc il ne peut pas toujours les distinguer.

La touche écrit le mauvais caractère

Si event.code est juste mais event.key est faux, votre ordinateur utilise une autre disposition de clavier. Changez-la dans les réglages de langue ou de clavier de votre ordinateur. Si event.code est faux aussi, quelque chose remappe la touche : une application de remappage, ou le logiciel de votre clavier.

Sur un Mac, les touches pressées avec Commande maintenue n’affichent pas de keyup

macOS n’envoie pas le keyup des touches pressées pendant que Commande est maintenue, donc les navigateurs ne peuvent pas toujours le signaler.

keyCode est différent dans un autre navigateur

Firefox envoie en général d’autres nombres pour quelques touches, comme 59 pour la touche point-virgule, là où Chrome envoie 186 sur un clavier américain. Les touches de ponctuation changent aussi avec la disposition du clavier. Utilisez plutôt event.code ou event.key.

Comment fonctionne ce test

Quand vous appuyez sur une touche, votre navigateur envoie à la page un événement keydown, puis un événement keyup quand vous la relâchez. L’outil montre les valeurs exactement comme votre navigateur les a envoyées. Rien n’est modifié ni deviné, sauf le nom de la touche, qui vient de event.code.

Dans la zone de touche, l’outil bloque l’action habituelle de chaque touche, donc F5 ou Ctrl + S affichent leurs codes au lieu de recharger ou d’enregistrer. Appuyez sur Échap, puis sur Tab, pour quitter la zone de touche.

La zone de texte montre ce qu’envoie un clavier à l’écran ou une méthode de saisie. Le texte y apparaît comme d’habitude, et le journal des événements liste aussi les événements beforeinput, input et composition.

Ce que l’outil peut voir

  • Chaque touche que votre navigateur transmet à la page, avec toutes ses valeurs.
  • Ce qu’une touche écrit sur votre disposition, dans Chrome et Edge sur ordinateur (Keyboard Map API). Il peut afficher votre disposition principale plutôt que celle utilisée.

Ce qu’il ne peut pas voir

  • Les touches que votre clavier ou votre ordinateur garde pour lui, comme Fn.
  • Les raccourcis que votre navigateur ou votre ordinateur garde, comme Ctrl + W ou Alt + F4.
  • Les scan codes et les codes de touches virtuelles de Windows.

Voyez comment nous testons les claviers pour connaître l’origine de nos limites et ce qu’un navigateur ne peut pas mesurer.

Questions et réponses

Qu’est-ce qu’un keycode ?

Un keycode indique à un site web quelle touche vous avez pressée. Votre navigateur l’envoie à chaque appui, par exemple 13 pour Entrée et 65 pour A.

Aujourd’hui, il y a trois valeurs. event.key est ce que la touche écrit ou fait. event.code indique de quelle touche il s’agit sur le clavier. event.keyCode est l’ancien nombre, toujours envoyé mais obsolète.

Quelle est la différence entre event.key et event.code ?

event.code nomme la place de la touche sur le clavier, comme KeyQ pour la touche à droite de Tab. Il reste le même sur toutes les dispositions, donc il convient aux jeux (WASD) et aux raccourcis.

event.key est ce que la touche écrit : « q » sur un clavier américain, « a » sur un clavier français, « Q » avec Maj. Utilisez-le quand le caractère compte.

keyCode est-il obsolète ? Que faut-il utiliser à la place ?

Oui. keyCode, which et charCode sont obsolètes. Les navigateurs les envoient encore, donc le vieux code continue de marcher, mais les nombres diffèrent selon les navigateurs et les dispositions de clavier. Dans du nouveau code, utilisez event.key ou event.code.

Pourquoi ai-je keyCode 229 ?

229 signifie qu’une méthode de saisie ou un clavier à l’écran a intercepté la touche. Les claviers Android l’envoient pour presque chaque touche, avec event.key « Unidentified ». Les iPhone envoient en général la vraie touche. La saisie en japonais, chinois et coréen l’envoie pendant qu’un caractère se construit. Lisez plutôt le texte dans l’événement input.

Sur quelle touche suis-je en train d’appuyer ?

Appuyez dessus dans la zone de touche. La grande touche affiche son nom, comme Alt Gr ou Pavé num. Entrée. La valeur event.code à côté nomme la touche exacte, la même sur toutes les dispositions de clavier.

Puis-je voir le scan code d’une touche ?

Non. Les navigateurs ne donnent pas aux sites web le scan code ni le code de touche virtuelle de Windows. Sous Windows, la fenêtre Key History d’AutoHotkey montre les deux.

Ce site enregistre-t-il ce que j’écris ?

Non. La page montre vos appuis de touches seulement sur votre écran. Elle ne les enregistre ni ne les envoie.