CKTIS / JavaScript
KeyboardEvent.code — touche physique plutôt que caractère
KeyboardEvent.code identifie la position physique d’une touche indépendamment de la disposition du clavier et des modificateurs. Découvrez la différence entre code et key, ainsi que les cas où la saisie de texte et les claviers virtuels nécessitent une autre approche.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
event.codeKeyboardEvent.code est une propriété en lecture seule qui renvoie sous forme de chaîne l’identifiant d’une touche physique. Lisez-la avec event.code, par exemple dans un gestionnaire keydown ou keyup. Elle fait partie de l’API Web UI Events, et non d’ECMAScript lui-même.
Des noms comme KeyQ, Digit2 et ShiftLeft décrivent des positions de touches, pas les caractères saisis. KeyQ désigne la position de la touche Q sur un clavier américain, même si une autre disposition lui associe une autre lettre. ShiftLeft et ShiftRight distinguent les côtés du clavier.
Contrairement à code, key décrit la signification de la touche en tenant compte de la disposition et des modificateurs. Choisissez code pour les commandes fondées sur la position et key pour connaître la signification de la touche. Pour observer la saisie de texte, utilisez input plutôt que de reconstruire le texte à partir des codes de touches.
La valeur par défaut de code est "". Les claviers virtuels n’ont pas toujours d’équivalent sans ambiguïté à une position physique. Testez les navigateurs et appareils visés ; la présence de Node 24 ne prouve pas la prise en charge de cette API de navigateur.
L’exemple définit explicitement code et key dans des événements synthétiques. Il montre deux significations différentes pour un même code ; il ne teste pas la correspondance d’un vrai clavier et ne simule pas l’appui sur une touche physique.
Exemples
const events = [
new KeyboardEvent("keydown", { code: "KeyQ", key: "q" }),
new KeyboardEvent("keydown", { code: "KeyQ", key: "Q", shiftKey: true })
];
for (const event of events) {
console.log(`${event.code} | ${event.key} | ${event.shiftKey}`);
}Résultat
KeyQ | q | false KeyQ | Q | true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.