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

CKTIS / JavaScript

Clés calculées de propriétés et de méthodes

Les crochets dans une définition de propriété ou de méthode permettent à une expression de déterminer sa clé. La clé est définie lors de la création de l’objet ; modifier ensuite la variable utilisée dans cette expression ne renomme pas la propriété.

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

({ [keyExpression]: value, [methodKeyExpression](parameters) { /* body */ } })

Dans un littéral d’objet, [expression]: value évalue l’expression et utilise son résultat comme clé de propriété. La forme [expression](parameters) {} définit une méthode dont le nom est calculé, sans deux-points ni mot-clé function. Cette syntaxe pour les noms de méthode fonctionne aussi dans les classes.

Pour obtenir une clé de propriété, JavaScript convertit d’abord un objet en valeur primitive. Si la valeur obtenue ou déjà primitive est un symbole, JavaScript l’utilise telle quelle comme clé ; sinon, il la convertit en chaîne de caractères. Par exemple, [1] et ["1"] désignent la même clé, tandis qu’un objet standard qui encapsule un symbole donne le symbole sous-jacent, et non une chaîne. Dans un littéral d’objet, l’expression de clé est évaluée lors de la création de l’objet, et non à chaque lecture.

Distinguez la définition { [key]: value } de l’accès obj[key]. La forme { key: value } utilise le nom littéral key, et obj.key lit ce nom, pas la valeur de la variable. Les crochets sont également nécessaires pour appeler une méthode dont le nom est stocké dans une variable : obj[methodKey]().

Cette syntaxe date d’ECMAScript 2015 et est largement prise en charge par les navigateurs modernes ; elle ne nécessite aucune Web API. JSON n’autorise ni les clés calculées ni les méthodes. Cas particulier : ["__proto__"]: value crée une propriété propre ordinaire, tandis que __proto__: value dans un littéral d’objet est une syntaxe de définition du prototype.

Identifiants de référence couverts par cette entrée : Computed property and method keys.

Exemples

let key = "score";
const methodKey = "read";
const record = {
  [key]: 7,
  [methodKey]() {
    return this.score;
  },
};
key = "other";
console.log(record.score);
console.log(record[methodKey]());
console.log(record[key]);

Résultat

7
7
undefined

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