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

CKTIS / JavaScript

Syntaxe d’accès aux propriétés

Le point désigne un nom fixe, tandis que les crochets calculent la clé. L’accès privé et le chaînage optionnel obéissent à des règles distinctes.

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

Syntaxe

obj.name
obj[expr]
obj.#name
obj?.name
obj?.[expr]
obj?.#name

Dans obj.name, name désigne une clé textuelle fixe, pas une variable. Le point est suivi d’un IdentifierName : obj.default est valide, mais la clé "display-name" exige obj["display-name"]. Dans obj[expr], JavaScript évalue l’expression et convertit son résultat en clé : il obtient une valeur primitive, la conserve s’il s’agit d’un Symbol et la convertit sinon en chaîne. Ainsi, obj[1] et obj["1"] utilisent la même clé.

Sur un objet ordinaire, une lecture peut trouver une propriété propre ou héritée et déclencher un getter. Une propriété absente donne undefined, mais une propriété présente peut aussi avoir cette valeur. Object.hasOwn(obj, key) vérifie si la propriété est propre. obj.name et obj["name"] peuvent servir de cibles d’affectation, mais les règles de la propriété régissent l’écriture, qui peut appeler un setter. obj.show() et obj["show"]() transmettent tous deux obj comme valeur de this ; lire la fonction ne la lie pas à l’objet.

obj.#name désigne un élément privé, pas une propriété de clé "#name". Le nom privé doit être déclaré dans une portée de classe accessible lexicalement, sinon le code produit une SyntaxError. Lire cet élément sur un objet qui ne le possède pas déclenche une TypeError. obj["#name"] ne permet pas d’y accéder.

Une lecture ordinaire sur null ou undefined déclenche une TypeError. Avec obj?.name ou obj?.[expr], l’une ou l’autre de ces valeurs de base interrompt la chaîne continue et donne undefined, sans évaluer expr. obj?.#name reste soumis aux règles d’accès privé. ?. n’intercepte pas les exceptions des getters, et une chaîne optionnelle ne peut pas servir de cible d’affectation.

Vérifie les clés de source non fiable au moyen d’une liste de noms autorisés, surtout avant l’écriture : une clé non vérifiée peut désigner une propriété inattendue et certaines écritures peuvent modifier un prototype. Ces formes relèvent d’ECMAScript 2024, pas d’API de navigateur ; vérifie leur prise en charge dans l’environnement cible.

Exemples

(() => {
  const key = "display-name";
  const token = Symbol("token");
  const obj = {
    name: "Ada",
    [key]: "A. Lovelace",
    1: "one",
    [token]: "symbol",
    show() { return this.name; },
  };

  console.log(obj.name);
  console.log(obj[key]);
  console.log(obj[1] === obj["1"]);
  console.log(obj[token]);
  console.log(obj["show"]());
  console.log(obj.profile?.[key]);
})();

Résultat

Ada
A. Lovelace
true
symbol
Ada
undefined

Le résultat `true` montre que `1` et `"1"` désignent la même clé. L’appel avec les crochets conserve `obj` comme valeur de `this`, et la dernière lecture s’interrompt parce que `profile` est absent.

Leçons associées

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

Sources