CKTIS / JavaScript
Object.getOwnPropertyDescriptor — examiner une propriété propre
Object.getOwnPropertyDescriptor renvoie une description d’une propriété propre de l’objet : sa valeur ou ses accesseurs, ainsi que ses indicateurs d’attribut. La chaîne de prototypes n’est pas parcourue et la méthode renvoie undefined si l’objet ne possède pas cette propriété propre.
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
Object.getOwnPropertyDescriptor(obj, key)Object.getOwnPropertyDescriptor(obj, key) lit le descripteur d’une propriété propre unique, y compris si elle n’est pas énumérable. La recherche ne parcourt pas les prototypes. Le résultat est un nouvel objet descripteur, ou undefined si la propriété ne se trouve pas directement dans obj. Une propriété existante dont la valeur est undefined possède tout de même un descripteur.
Un descripteur de propriété de données contient value, writable, enumerable et configurable. Un descripteur de propriété d’accesseur contient get et set à la place de value et writable ; un accesseur absent vaut undefined. Pour un objet ordinaire, lire le descripteur n’appelle pas le getter. writable détermine si une affectation peut modifier la valeur, enumerable si la propriété est incluse dans une énumération, et configurable si elle peut être supprimée ou reconfigurée.
Modifier les champs de l’objet renvoyé ne modifie pas la propriété d’origine. Pour appliquer un descripteur, utilisez Object.defineProperty, en tenant compte des restrictions de la propriété existante. Le descripteur n’est pas une copie profonde : un objet stocké dans value reste la même référence.
key est converti en clé de propriété : une chaîne ou un symbole. Passer null ou undefined comme obj déclenche une TypeError ; les autres valeurs primitives sont enveloppées dans des objets. Pour un Proxy, l’opération peut appeler le piège getOwnPropertyDescriptor et peut donc avoir des effets de bord ou lever une exception.
Exemples
const obj = Object.create({ inherited: 1 });
Object.defineProperty(obj, "score", {
value: 42,
writable: false,
enumerable: true,
configurable: true
});
const descriptor = Object.getOwnPropertyDescriptor(obj, "score");
console.log(descriptor.value, descriptor.writable);
console.log(descriptor.enumerable, descriptor.configurable);
descriptor.value = 99;
console.log(obj.score);
console.log(Object.getOwnPropertyDescriptor(obj, "inherited"));Résultat
42 false true true 42 undefined
Le 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.