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

CKTIS / JavaScript

Clé de propriété calculée dans un littéral d’objet

La syntaxe `[expression]: valeur` détermine une clé de propriété à la création de l’objet. Le résultat est une chaîne ou un symbole.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const obj = { [keyExpression]: valueExpression };
const withMethod = { [keyExpression]() {} };

Dans le littéral { [key]: value }, JavaScript détermine la clé à partir de la valeur de key. Dans { key: value }, la clé est littéralement "key". Les crochets permettent aussi de nommer une méthode : { [key]() {} }. En dehors du littéral, obj[key] accède à une propriété au lieu de la définir dans le littéral.

À chaque évaluation du littéral, les définitions sont traitées de gauche à droite. Dans [key]: value, la clé est évaluée et convertie avant l’évaluation de la valeur. Modifier ensuite la variable key ne renomme pas la propriété. Si l’évaluation ou la conversion de la clé lève une exception, l’expression de valeur n’est pas évaluée.

ToPropertyKey convertit d’abord le résultat en valeur primitive en privilégiant les chaînes. Il conserve un Symbol tel quel et convertit les autres valeurs primitives en chaînes. Ainsi, [1] et "1" désignent la même clé. Si deux définitions de propriétés de données produisent la même clé, la dernière l’emporte. Pour lire une propriété dont la clé est un symbole, utilisez le même symbole, pas un nouveau symbole portant la même description.

{ ["__proto__"]: null } crée une propriété de données propre et laisse le prototype inchangé. { __proto__: null } et { "__proto__": null } fixent au contraire le prototype à null sans créer cette propriété. Une affectation ultérieure à un autre objet peut toujours appeler un accesseur d’écriture hérité. JSON n’autorise pas les noms de propriétés calculés. ECMAScript 2024 spécifie cette syntaxe ; vérifiez la compatibilité si vous ciblez des environnements d’exécution plus anciens.

Exemples

{
  const key = "score";
  const token = Symbol("score");
  const obj = {
    [key]: 10,
    key: 20,
    [token]: 30,
    [1]: 40,
    "1": 50,
    ["__proto__"]: null,
  };

  console.log(obj[key]);
  console.log(obj.key);
  console.log(obj[token]);
  console.log(obj[1]);
  console.log(obj["__proto__"] === null && Object.getPrototypeOf(obj) === Object.prototype);
}

Résultat

10
20
30
50
true

`obj[key]` renvoie `10`, la valeur de la propriété de clé `"score"`, tandis que `obj.key` renvoie `20`, la valeur de la propriété de clé littérale `"key"`. Le symbole est une clé distincte. La définition `"1"`, placée après `[1]`, la remplace. Le dernier test vérifie la valeur de `__proto__` et confirme que le prototype n’a pas changé.

Leçons associées

  • JavaScript · Leçon 17 · Avancé · Version : 4

Sources