CKTIS / JavaScript
Accès à une propriété d’objet par clé calculée
Utilisez `obj[expr]` pour lire ou affecter une propriété sélectionnée par une expression plutôt que par un nom fixe après un point.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
obj[expr] // read using a computed key
obj[expr] = value // assign using a computed key
obj?.[expr] // optional computed access
obj.name // access the fixed string key "name"
({ [expr]: value }) // define a property in an object literalAvec obj[expr], JavaScript évalue expr pour sélectionner la propriété à lire ou à affecter. obj.key désigne toujours la clé de type chaîne "key" ; obj[key] utilise la valeur de la variable key. À l’inverse, { [expr]: value } définit une propriété lors de la création d’un objet au lieu de la lire sur un objet existant.
ToPropertyKey convertit d’abord la valeur de la clé en valeur primitive. Si le résultat est un Symbol, il est conservé ; sinon, il est converti en chaîne. Ainsi, obj[1] et obj["1"] désignent la même propriété. Les crochets acceptent des chaînes contenant des espaces, mais obj["#secret"] ne donne pas accès au champ privé de classe #secret.
Sur un objet ordinaire, une lecture peut trouver une propriété héritée ou appeler un accesseur en lecture (getter). Si la propriété est absente de toute la chaîne de prototypes, la lecture renvoie undefined, tout comme pour une propriété dont la valeur est undefined. Utilisez Object.hasOwn(obj, key) pour vérifier que la propriété appartient directement à l’objet. Avant toute lecture ou écriture avec une clé de source non fiable, vérifiez qu’elle figure dans une liste de clés autorisées ; Object.hasOwn ne remplace pas cette vérification.
Une lecture normale sur null ou undefined lève une TypeError, sauf si une autre erreur survient avant. Sur ces valeurs de base, obj?.[expr] renvoie undefined sans évaluer expr. Cette syntaxe n’intercepte pas les erreurs d’un getter et ne peut pas servir de cible d’affectation. Il s’agit de syntaxe JavaScript, pas d’une API du DOM ; vérifiez la prise en charge de ?. et de Object.hasOwn sur les anciens environnements d’exécution.
Exemples
{
const key = "display count";
const tag = Symbol("status");
const obj = { key: 0, [key]: 2, [tag]: "ready" };
obj[key] = obj[key] + 1;
console.log(obj[key]);
console.log(obj.key);
console.log(obj[tag]);
const absent = null;
console.log(String(absent?.[key]));
}Résultat
3 0 ready undefined
`obj[key]` passe de `2` à `3`, mais `obj.key` vaut toujours `0`. `obj[tag]` lit `ready` via une clé de type `Symbol`, et l’accès optionnel sur `null` donne `undefined`.
Leçons associées
- JavaScript · Leçon 38 · Avancé · Version : 4
- JavaScript · Leçon 44 · Avancé · Version : 4