Object.getOwnPropertyDescriptors()

La méthode Object.getOwnPropertyDescriptors() renvoie l'ensemble des descripteurs des propriétés propres d'un objet donné.

Syntaxe

Object.getOwnPropertyDescriptors(obj)

Paramètres

obj
L'objet dont on souhaite connaître les descripteurs des propriétés.

Valeur de retour

Un objet qui contient tous les descripteurs des propriétés propres de l'objet passé en paramètre. S'il n'y aucune propriété, cela sera un objet vide.

Description

Cette méthode permet d'examiner de façon précise les différentes propriétés directement rattachées à un objet. Une propriété JavaScript se définit par un nom (une chaîne de caractères) et un descripteur. Vous pouvez trouver de plus amples informations sur les types de descripteurs et sur leurs attributs sur la page de Object.defineProperty().

Un descripteur de propriété est un enregistrement qui possède les attributs suivants :

value
La valeur associée à la propriété (uniquement pour les descripteurs de données).
writable
true si et seulement si la valeur associée à la propriété peut être changée (uniquement pour les descripteurs de données).
get
Une fonction qui est utilisée comme accesseur pour la propriété ou undefined s'il n'existe pas de tel accesseur (uniquement pour les descripteurs d'accesseur/mutateur).
set
Une fonction qui est utilisée comme mutateur pour la propriété ou undefined s'il n'existe pas de tel mutateur (uniquement pour les descripteurs d'accesseur/mutateur).
configurable
true si et seulement si le type de descripteur peut être changé et si la propriété peut être supprimée de l'objet correspondant.
enumerable
true si et seulement si cette propriété est listée lorsqu'on énumère les propriétés de l'objet correspondant.

Exemples

Créer un clone

La méthode Object.assign() ne copiera que les propriétés propres et énumérables d'un objet source vers un objet cible. On peut donc utiliser cette méthode avec Object.create() afin de réaliser une copie « plate » entre deux objets inconnus :

Object.create(
  Object.getPrototypeOf(obj), 
  Object.getOwnPropertyDescriptors(obj) 
);

Créer une sous-classe

Pour créer une sous-classe, généralement, on définit la sous-classe et on définit son prototype comme étant une instance de la classe parente. Enfin on définit les propriétés de cette nouvelle sous-classe.

function superclass() {};
superclass.prototype = {
  // on définit les méthodes et propriétés
  // de la classe parente
};

function subclass() {};
subclass.prototype = Object.create(superclass.prototype, Object.getOwnPropertyDescriptors({
  // on définit les méthodes et propriétés
  // de la sous-classe
}));

Spécifications

Spécification État Commentaires
ECMAScript 2017 Draft (ECMA-262)
La définition de 'Object.getOwnPropertyDescriptors' dans cette spécification.
Projet Définition initiale avec ES8/ECMAScript 2017.

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple 54 50 (50) ? 41 10
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple ? ? 50.0 (50) ? ? ?

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,