CKTIS / JavaScript
Reflect.getOwnPropertyDescriptor — examiner une propriété propre
Reflect.getOwnPropertyDescriptor(target, key) renvoie le descripteur d’une propriété propre ou undefined. Il permet d’examiner la valeur, les accesseurs et les attributs d’une propriété sans parcourir la chaîne des prototypes.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Reflect.getOwnPropertyDescriptor(target, key)Reflect.getOwnPropertyDescriptor(target, key) décrit uniquement une propriété propre de target, y compris si elle n’est pas énumérable. Il renvoie un nouvel objet descripteur ou undefined si la propriété n’est pas propre. Une propriété héritée n’est pas recherchée dans la chaîne des prototypes ; une propriété propre dont la valeur est undefined possède tout de même un descripteur.
Un descripteur de données contient value, writable, enumerable et configurable. Un descripteur d’accesseur contient get et set à la place de value et writable ; leurs valeurs sont des fonctions ou undefined. Examiner le descripteur d’un objet ordinaire n’appelle pas son getter. Modifier le descripteur renvoyé ne redéfinit pas la propriété ; utilisez par exemple Object.defineProperty pour cela.
target doit être un objet ; toute valeur primitive, y compris null et undefined, provoque une TypeError. Cela diffère de Object.getOwnPropertyDescriptor, qui encapsule les valeurs primitives autres que null et undefined. L’opération ToPropertyKey convertit key en clé de propriété. Si key est un objet, elle le convertit d’abord en valeur primitive, par exemple en appelant sa méthode Symbol.toPrimitive. Si la valeur primitive est un symbole, il est conservé comme clé ; sinon, la valeur est convertie en chaîne de caractères.
Ne supposez pas que l’opération est toujours sans effets secondaires : la conversion de key peut exécuter du code utilisateur, et un Proxy peut déclencher son piège getOwnPropertyDescriptor. Les exceptions qui en résultent sont propagées à l’appelant. L’exemple montre qu’une propriété héritée est ignorée et que modifier descriptor.value ne change pas item.score.
Exemples
const item = Object.create({ inherited: 1 });
Object.defineProperty(item, "score", {
value: 42,
writable: false,
enumerable: true,
configurable: true
});
const descriptor = Reflect.getOwnPropertyDescriptor(item, "score");
console.log(JSON.stringify(descriptor));
console.log(Reflect.getOwnPropertyDescriptor(item, "inherited"));
descriptor.value = 99;
console.log(item.score);Résultat
{"value":42,"writable":false,"enumerable":true,"configurable":true}
undefined
42Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.