CKTIS / JavaScript
Accès à une propriété par clé calculée
La notation entre crochets `obj[expr]` sélectionne une propriété à partir de la valeur d’une expression. Elle permet de lire ou de modifier des propriétés et d’appeler des méthodes dont la clé est déterminée à l’exécution.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
object[expression]
object[expression] = value
object[expression](...args)
object?.[expression]Dans obj[expr], la valeur de expr détermine la clé de propriété. obj.key utilise toujours la chaîne "key", tandis que obj[key] utilise la valeur de la variable key. Les crochets permettent aussi d’utiliser des clés contenant des espaces. Dans { [expr]: value }, ils indiquent un nom de propriété calculé : on définit une propriété dans un littéral d’objet au lieu de la lire sur un objet existant.
ToPropertyKey convertit la valeur de la clé en valeur primitive. Si celle-ci est un Symbol, elle est conservée ; sinon, elle est convertie en chaîne. Ainsi, obj[1] et obj["1"] désignent la même propriété. La conversion d’un objet utilisé comme clé peut exécuter du code et lever une exception.
Une lecture ordinaire peut parcourir la chaîne de prototypes et appeler un accesseur en lecture (getter). Une propriété absente donne undefined, mais une propriété existante peut aussi donner undefined. Object.hasOwn(obj, key) vérifie qu’il s’agit d’une propriété propre. obj[key] = value suit les règles ordinaires d’affectation, et un appel direct obj[key]() a pour récepteur obj, comme obj.method().
Une lecture directe sur null ou undefined lève une TypeError. Avec une telle base, obj?.[expr] renvoie undefined sans évaluer expr ; cette forme ne peut pas être la cible d’une affectation. L’accès entre crochets relève d’ECMAScript, pas d’une API de navigateur. Vérifiez que votre environnement cible prend en charge ?. et Object.hasOwn.
Les crochets ne valident pas les clés provenant de l’extérieur. Avant de lire ou d’écrire à partir d’une entrée non fiable, limitez les clés à une liste explicite de valeurs autorisées. Object.hasOwn ne vérifie pas à lui seul les autorisations.
Exemples
{
const key = "total points";
const token = Symbol("bonus");
const scores = { [key]: 7, [token]: 2, "1": "first" };
console.log(`before: ${scores[key]}`);
scores[key] = 9;
console.log(`after: ${scores[key]}`);
console.log(`literal key: ${scores.key}`);
console.log(`symbol key: ${scores[token]}`);
console.log(`numeric key: ${scores[1]}`);
let evaluations = 0;
const missing = null;
console.log(`optional: ${missing?.[evaluations++]}`);
console.log(`evaluations: ${evaluations}`);
}Résultat
before: 7 after: 9 literal key: undefined symbol key: 2 numeric key: first optional: undefined evaluations: 0
L’exemple modifie la valeur associée à une clé contenant un espace et montre que `scores.key` recherche la clé littérale `"key"`. Le dernier accès n’évalue pas `evaluations++`, donc le compteur reste à `0`.
Leçons associées
- JavaScript · Leçon 24 · Avancé · Version : 4
- JavaScript · Leçon 25 · Avancé · Version : 4
- JavaScript · Leçon 29 · Avancé · Version : 4