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

CKTIS / JavaScript

Notation abrégée des propriétés et accès par clé calculée

Utilisez la notation abrégée quand la variable et la propriété portent le même nom, et les crochets quand une expression détermine la clé à la création ou à l’accès.

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

Syntaxe

const obj = { name, [keyExpression]: value };
obj.name;
obj[keyExpression];
obj[keyExpression] = newValue;

Dans un littéral d’objet, { name } crée une propriété de données propre à l’objet, avec la clé "name" et la valeur actuelle de la variable name. Pour un nom ordinaire, c’est la forme abrégée de { name: name }. Réaffecter la variable ne met pas la propriété à jour. Lire un identifiant non déclaré déclenche une ReferenceError.

Dans { [key]: value }, l’expression entre crochets est évaluée à la création de l’objet pour déterminer la clé d’une propriété de données propre. Une clé est une chaîne ou un symbole : un symbole conserve son identité, tandis que le nombre 1 devient la clé "1". En revanche, { key: value } utilise la clé littérale "key".

Lors d’un accès, obj[key] évalue l’expression qui donne la clé, tandis que obj.key signifie toujours obj["key"]. Les deux formes permettent de lire une propriété ou de lui affecter une valeur. Les crochets acceptent aussi des clés telles que "bonus-points" et des symboles. Une lecture ordinaire examine l’objet et sa chaîne de prototypes : si la propriété est absente partout, le résultat est undefined. Un accès sur null ou undefined déclenche une TypeError.

Attention à __proto__ : dans un littéral, { __proto__: value } fixe le prototype si value est un objet ou null, sans créer de propriété de données propre. { ["__proto__"]: value } crée au contraire une telle propriété. Avant d’écrire une propriété avec une clé de source non fiable, vérifiez qu’elle figure dans une liste de clés autorisées. Il s’agit de syntaxe ECMAScript, pas d’une API de navigateur ; vérifiez sa prise en charge dans l’environnement d’exécution cible.

Exemples

{
  let score = 7;
  const key = "bonus-points";
  const token = Symbol("bonus-points");
  const obj = { score, [key]: 14, [token]: 21 };

  score = 8;
  console.log(`${obj.score} | ${obj[key]} | ${obj.key} | ${obj[token]}`);

  obj[key] = 15;
  console.log(String(obj["bonus-points"]));
}

Résultat

7 | 14 | undefined | 21
15

`obj.score` vaut toujours `7` après la réaffectation de `score` à `8`. `obj[key]` lit `14`, `obj.key` donne `undefined` et `obj[token]` lit la propriété distincte dont la clé est un symbole. Après l’affectation via `obj[key]`, `obj["bonus-points"]` renvoie `15`.

Leçons associées

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

Sources