CKTIS / JavaScript
Object.getOwnPropertyDescriptors — descripteurs des propriétés propres
Pour un objet ordinaire, Object.getOwnPropertyDescriptors renvoie les descripteurs de toutes ses propriétés propres, y compris les propriétés non énumérables et celles dont la clé est un Symbol. Cette méthode permet d’examiner les attributs ou de copier des propriétés sans convertir les accesseurs en valeurs.
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.getOwnPropertyDescriptors(obj)Object.getOwnPropertyDescriptors(obj) renvoie un nouvel objet ordinaire. La méthode récupère auprès de obj la liste des clés de ses propriétés propres et inclut, pour chaque clé de la liste, le descripteur correspondant si obj en signale un. Elle prend en compte les clés de type chaîne et Symbol, y compris celles des propriétés non énumérables ; les propriétés héritées sont exclues.
Le descripteur d’une propriété de données contient value, writable, enumerable et configurable. Un descripteur d’accesseur contient get et set à la place de value et writable ; une fonction absente est représentée par undefined. La lecture des descripteurs d’un objet ordinaire n’appelle pas ses accesseurs en lecture. Avec un Proxy, toutefois, des pièges peuvent être déclenchés et des exceptions peuvent se produire. Le résultat peut aussi être incomplet sans qu’aucune exception soit levée : le piège ownKeys peut omettre la clé d’une propriété propre configurable d’une cible extensible, même si le proxy continue de signaler un descripteur de propriété propre pour cette clé. La méthode omet alors ce descripteur du résultat.
Pour un objet ordinaire, le modèle Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) crée une copie superficielle ayant le même prototype et les mêmes attributs de propriétés propres. Contrairement à Object.assign, il conserve les accesseurs et les propriétés non énumérables. Les objets imbriqués restent partagés ; ce n’est pas une méthode générale de clonage pour les objets qui dépendent de slots internes, tels que Map.
null et undefined provoquent un TypeError ; les autres valeurs primitives sont enveloppées dans des objets. Cette méthode fait partie d’ECMAScript 2017, et non des Web APIs. La prise en charge dans le navigateur cible doit être vérifiée séparément — sa disponibilité dans Node 24 ne la prouve pas.
Exemples
let reads = 0;
const source = Object.create(null);
Object.defineProperties(source, {
hidden: { value: 7, enumerable: false },
doubled: {
get() { reads += 1; return this.hidden * 2; },
enumerable: true
}
});
const descriptors = Object.getOwnPropertyDescriptors(source);
const copy = Object.create(Object.getPrototypeOf(source), descriptors);
console.log(reads);
console.log(descriptors.hidden.value, descriptors.hidden.enumerable);
console.log(typeof descriptors.doubled.get);
console.log(copy.doubled, reads);
console.log(Object.getPrototypeOf(copy) === null);Résultat
0 7 false function 14 1 true
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.