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

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.

Sources