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

CKTIS / JavaScript

Propriétés abrégées, méthodes concises et accès par clé calculée

Distinguez les propriétés abrégées et les méthodes concises dans un littéral d’objet de la lecture, de l’écriture et de l’appel avec une clé déterminée à l’exécution.

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

Syntaxe

const obj = {
  x,
  [key]: value,
  method(arg) { /* body */ },
  [methodKey](arg) { /* body */ },
};
obj.x;
obj[key];
obj[key] = value;
obj.method(arg);
obj[methodKey](arg);

Dans un littéral d’objet, { x } abrège { x: x }. Cette forme crée une propriété de données propre nommée "x" avec la valeur actuelle de la variable x. Réaffecter la variable par la suite ne modifie pas la propriété. Si la variable n’existe pas, l’évaluation du littéral déclenche une ReferenceError.

method(arg) { … } définit une méthode sans function. Contrairement à method: function (arg) { … } avec une fonction ordinaire, la méthode concise n’est pas un constructeur (new obj.method() déclenche une TypeError) et peut utiliser super pour chercher des propriétés sur le prototype de l’objet où elle a été définie. Dans obj.method(arg) et obj[methodKey](arg), obj est le receveur this. Stocker la méthode dans une variable ne conserve pas ce receveur.

{ [key]: value } et { [methodKey](arg) { … } } calculent une clé à la création de l’objet. obj[key] calcule la clé à chaque accès, tandis que obj.key désigne toujours la propriété "key". Les clés sont des chaînes ou des valeurs Symbol ; le nombre 1, par exemple, devient "1". Les crochets permettent aussi d’utiliser des noms incompatibles avec la notation pointée, comme dans obj["bonus-points"].

obj[key] lit une propriété et obj[key] = value lui affecte une valeur. Lors d’une recherche ordinaire de propriété, la lecture renvoie undefined si la clé est absente de l’objet et de sa chaîne de prototypes. Si l’objet lui-même ou un objet de sa chaîne de prototypes est un Proxy, son piège get peut renvoyer une autre valeur même si aucune propriété ne correspond à cette clé. Un accès sur null ou undefined déclenche une TypeError. Avant un accès dynamique, vérifiez les clés non fiables à l’aide d’une liste de clés autorisées, surtout en écriture.

Dans un littéral, { ["__proto__"]: value } crée une propriété de données propre ordinaire, tandis que { __proto__: value } est une syntaxe spéciale qui définit le prototype si value est un objet ou null. Ces formes font partie d’ECMAScript 2024 ; leur disponibilité dépend de l’environnement d’exécution.

Exemples

{
  const x = 2;
  const key = "bonus-points";
  const methodKey = Symbol("addBonus");
  const obj = {
    x,
    [key]: 3,
    total() {
      return this.x + this[key];
    },
    [methodKey](amount) {
      this[key] += amount;
      return this.total();
    },
  };

  console.log(obj.total());
  console.log(obj[methodKey](4));
  console.log(obj[key]);
  console.log(obj.key);
}

Résultat

5
9
7
undefined

`x` vaut `2` et `"bonus-points"` vaut initialement `3`. L’appel de la méthode par sa clé `Symbol` fait passer le bonus à `7` et renvoie le total `9`. `obj.key` cherche le nom littéral `"key"` et renvoie donc `undefined`.

Leçons associées

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

Sources