Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

KeyboardEvent.key — la signification d’une touche

KeyboardEvent.key est une propriété en lecture seule de type chaîne qui décrit la signification d’une touche. Elle tient compte de la disposition du clavier et des modificateurs ; contrairement à code, elle ne décrit pas la position physique de la touche.

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.key

KeyboardEvent.key, lu avec event.key, renvoie une chaîne décrivant la signification d’une touche. Pour les caractères imprimables, elle tient compte de la disposition du clavier et des modificateurs, par exemple "a" ou "A". La propriété est en lecture seule.

UI Events classe les valeurs nommées des touches en plusieurs catégories : "Enter" figure parmi les touches associées aux caractères d’espacement, "Escape" parmi les touches d’interface utilisateur et "ArrowDown" parmi les touches de navigation. La barre d’espace a pour valeur " ", et non "Space". "Dead" désigne une touche morte utilisée pour composer des caractères, tandis que "Unidentified" signifie que la touche n’a pas pu être identifiée. Les comparaisons de chaînes tiennent compte de la casse.

Utilisez key lorsque la signification de la touche importe, et code lorsque sa position physique importe. Ne considérez pas les événements clavier comme un relevé complet de la saisie de texte ; pour l’édition, envisagez les événements beforeinput et input.

Il s’agit d’une API Web de navigateur définie dans UI Events, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. La présence de Node 24 ne prouve pas sa prise en charge. L’exemple définit explicitement key et code : le constructeur ne calcule pas key à partir de code ou de shiftKey. Il teste l’accès aux valeurs, pas un clavier réel ; la prise en charge dans les navigateurs ciblés doit être vérifiée séparément.

Exemples

const events = [
  new KeyboardEvent("keydown", { key: "a", code: "KeyA" }),
  new KeyboardEvent("keydown", { key: "A", code: "KeyA", shiftKey: true }),
  new KeyboardEvent("keydown", { key: "Enter", code: "Enter" })
];

console.log(events.map(event => `${event.key}:${event.code}`).join("\n"));

Résultat

a:KeyA
A:KeyA
Enter:Enter

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.

Sources